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Preface 


How the Book is Organized 


The System Logic Library is intended for people who debug or modify the MVS 
control program. It describes the logic of most MVS control program functions 
that are performed after master scheduler initialization is complete. Refer to 
OS/VS2 System Initialization Logic for detailed information about the MVS 
control program prior to this point; to the OS/VS2 MVS Overview for general 
information about the MVS control program and the relationships among the 
components; and to the list of Corequisite Reading later in the preface to obtain 
the names of publications that describe compre not included in the System 
Logic Library. 


The System Logic Library is comprised of eleven volumes. A copy of this preface, 
describing the organization and use of the book, can be found in each of the eleven 
volumes. Volume 1 contains the master table of contents and master index for the 
remaining volumes. Each of the other volumes contains its own index referring to 
the information in that particular volume; Volumes 2-10 each contain a table of 
contents. Volumes 2-10 describe the logic of the components in the MVS control 
program. Volume 11 contains module descriptions for all of the modules in the 
components documented in the System Logic Library. 


The information in Volumes 2 through 10 is organized alphabetically by section 
name. Each section contains information pertaining to one or more of the 
components in the MVS control program. A section contains more than one 
component when the components are closely related, frequently referenced at the 
same time, and not so large that they require a volume of their own. 


A three or four character mnemonic is associated with each section and used in the 
identification of all figures, diagrams, and pages in that section. For example, the 
mnemonic ASM is associated with the section “Auxiliary Storage Management.” 
All figures in this section are identified as Figure ASM-n, all diagrams as Diagram 
ASM-n, and all pages as ASM-n, where n represents the specific figure, diagram, or 
page number. Whenever possible, existing component acronyms are used as the 
mnemonic for a section. The mnemonics have all been chosen so that they are in 
alphabetic order along with the full section name. The section names, the 
components included in each section (if a section contains more than one 
component), the mnemonics for the sections, and the volume and order number for 
each section are given in the table on page v. 


The order number for Volume 1 (containing the master table of contents and 
index) is SY28-0713; the order number for Volume 11 (containing the module 
descriptions) is LY28-1099. Please note that the order numbers are not 
consecutive. This has been done to allow for the expansion of existing sections and 
the addition of the new sections. 
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How to Use the Book 
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In order to use this book efficiently, readers must be able to find the information 
that they need quickly; they must be aware of the types of information provided for 
each component; and they must know how to obtain additional information before 
referencing the System Logic Library. The following topics cover these points. 


Finding Information Using the Master Index 


Readers who are not familiar with the organization of the System Logic Library can 
locate information by using the master index in Volume 1. All index entries in 
volume 1 specify a volume number in parenthesis, followed by a page number. For 
Volumes 2-10, the page number consists of the mnemonic for the section and the 
page number; for Volume 11 (which contains the module descriptions), the page 
number consists of the volume number instead of a mnemonic and the page 
number. For example: 


(3) ASM-12 refers to Volume 3, the “Auxiliary Storage Management” section, page 
ASM-12. 
(11) 11-15 refers to Volume 11, page 11-15. 


The volume number and section mnemonic are not repeated for successive 
references to the same section in a single entry in the master index; for example, 
(3) ASM-12, 17 refers to both pages 12 and 17. The volume number in 
parenthesis is not included in the individual index entries in Volumes 2-11, since all 
entries apply to the same volume. 


Finding Information Using the Volume Titles 


As readers become familiar with the section names, their mnemonics, and contents, 
they will not need to go to Volume 1, but will be able to use the individual indexes 
in each volume. They will be able to use the System Logic Library as they would an 
encyclopedia and go directly to the volume that they need. To help readers locate 
the correct volume, section mnemonics are included in the titles of Volume 2-10. If 
a volume contains one section, the mnemonic for that section is specified; if a 
volume contains more than one section, the mnemonics for the first and last section 
in the volume are specified. For example: 


Volume'2 (ALC) indicates that Volume 2 contains only the section identified by 
the mnemonic ALC (Allocation/Unallocation). 
Volume 6 (CSV-PCA) indicates that Volume 6 contains the sections identified by the 


mnemonics CSV and PCA as well as all the sections that fall 
between them in alphabetical order. Therefore, volume 6 
contains the sections identified by the mnemonics CSV 
(Contents Supervision), CVI (Converter/Interpreter), ENF 
(Event Notification Facility), INIT (Initiator/ Terminator), MSI 
(Master Subsystem/Subsystem interface), and PCA 
(PC/AUTH Service Routines). 


The list of section names and mnemonics on page v of this preface is included in 
every volume and provides a quick reference to the mnemonics and the 
components included in each section. 
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Table of Section Names 


Volume 
Section and 
Section Name Mnemonic Order Number 
C 
ASM 
C 


Allocation/Unallocation AL Volume 2 
LY28-1063 


Auxiliary Storage Management Volume 3 
Checkpoint/Restart HK LY28-1067 


Command Processing Volume 4 
Includes: 
Command Processing 
System Log 
Region Control Task 
System Component Address 
Space Initialization 
Started Task Control 


LY28-1071 
LY28-1075 
Contents Supervision (Program Management) 
Converter/Interpreter | 
Event Notification Facility 
Initiator/Terminator 
Master Subsystem/Subsystem Interface: 
Includes: 
Master Subsystem 
Subsystem Interface 
SWA Create Interface 
SWA Manager 
PC/AUTH Service Routines 


PCA 
Real Storage Management 
Recovery Support (Recovery Management Support) 
Includes: 
Machine Check Handler 
Power Warning Feature 
Channel Check Handler 
Dynamic Device Reconfiguration 
Missing Interrupt Handler 


Volume 6 
LY28-1079 


Volume 7 
LY28-1083 


Volume 8 
LY28-1087 


Recovery Termination Management 
Includes: 
RTM1 
RTM2 
Dumping Services 
SLIP 


Scheduler JCL Facility | SCH Volume 9 
Supervisor Control SCTL LY28-1091 
System Management Facilities SMF 


Volume 10 
LY28-1095 


System Resources Manager 
Task Management . 


Timer Supervision 
Virtual Storage Management 


Note: TSO LOGON has been moved to OS/VS2 TSO Command Processor 


Logic, Volume IV. 
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Information Provided for Each Component 


The following information is provided for each of the components 
described in the System Logic Library. 


1. An introduction that summarizes the component’s function 


2. Module flow diagrams that show control flow between the 
component’s object modules 


3. Control block overview diagrams that show significant fields and the 
chaining structure of the component’s control blocks 


4. Method-of-operation diagrams (sometimes called HIPOs or logic 
diagrams) that describe the functional organization of a program 


5. Module descriptions that describe the operation of the modules 


Items 1 through 4 are located in Volumes 2-10 in the section pertaining to 
the component; item 5 is located in Volume 11. 


The following figure shows the symbols used in method-of-operation 
diagrams. The relative size and the order of fields in control block 
illustrations do not always represent the actual size and format of the 
control block. 


Key to Symbols Used in Method-of-Operation Diagrams 


Primary processing -- indicates major functional flow. 


Secondary processing -- indicates functional flow 
within a diagram. 


Data movement, modification, or use. 


Data reference -- indicates the testing or reading 
of a data area to determine the 
course of subsequent processing. 


Pointer -- indicates that a data area contains the 
address of another data area. 


Indirect pointer -- indicates intermediate pointers 
have been omitted. 


Connector -- indicates that a diagram is 
continued on the next page. 
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Paths Into the System Logic Library 


As a system programmer you might need additional information before 
referring to the System Logic Library. Other books in the library support 
debugging; understanding the information they provide can help you use 
the System Logic Library more efficiently. Possible problems and where to 
find helpful information follows. The exact titles of the microfiche 
publications are provided under Corequisite Reading later in the preface. 


If you need to know the detailed structure of a data area, refer to 
Data Areas (microfiche) or to Volumes 2 and 3 of the OS/VS2 System 
Programming Library: Debugging Handbook. You will find 
miscellaneous debugging information in Volume 1 of this publication. 


If you are trying to determine which modules use or change a data 
area or field, refer to the Data Areas Usage Table (microfiche) or to 
the Symbol Usage Table (microfiche). 


If you need to correlate CSECT names, aliases, and entry points of a 
load module, refer to the Directory (microfiche). 


To determine what module issues a message or detects the error 
conditions documented in the message, refer to the appendix of 
OS/VS Message Library: VS2 System Messages. 


To determine the meaning of an abend code and the module that 
detects or issues it, refer to OS/VS Message Library: VS2 System 
System Codes. 


If you have not identified the failing component, refer to OS/VS2 
System Programming Library: Diagnostic Techniques, which documents 
a debugging methodology, including information on analyzing 
stand-alone dumps. Diagnostic Techniques also contains diagnostic 
information for some components. 


Corequisite Reading 


Prerequisite information can be found in: 


OS/VS2 MVS Overview, GC28-0984 


Other publications that support the task of debugging are: 


For MVS/SP-JES2 Release 2: 

- Data Areas, LYB8-1051 (microfiche) 

- Data Areas Usage Table, LYB8-1052 (microfiche) 
- Directory, LYB8-1053 (microfiche) 

- Symbol Usage Table, LYB8-1054 (microfiche) 


For MVS/SP-JES3 Release 2: 

- Data Areas, LYB8-1055 (microfiche) 

- Data Areas Usage Table, LYB8-1056 (microfiche) 
- Directory, LYB8-1057 (microfiche) 

- JES3 Messages, GC23-0044 

- Symbol Usage Table, LYB8-1058 (microfiche) 


OS/VS Message Library: VS2 System Codes, GC38-1008 

OS/VS Message Library: VS2 System Messages, GC38-1002 

OS/VS2 System Programming Library: MVS Diagnostic Techniques, 
GC28-0725 

OS/VS2 System Programming Library: Debugging Handbook, Volumes 
1, 2, and 3, GC28-1047, GC28-1048, and GC28-1049 


Preface _ vii 


Licensed Material — Property of IBM 


The following publications provide logic information for components not 
described in the System Logic Library: 


e Global resource - OS/VS2 Global Resource Serialization Logic, 
serialization LY28-1059 

e I/O supervisor - OS/VS2 I/O Supervisor Logic, S¥26-3823 

e JES2 - JES2 Logic, LY24-6006 

« JES3 - JES3 Logic, LY24-6005 

e RMF - OS/VS2 MVS. Resource Measurement Facility 


(RMF) Program Logic Manual, LY28-0923 
e System initialization - OS/VS2 System Initialization Logic, LY28-1050 
« TCAM - OS/VS2 TCAM Level 10 Logic, S¥30-3032 
e = =6©TSO LOGON - OS/VS2 TSO Command Processor Logic Volume 
IV, SY28-0652 
e VTAM - OS/VS2 MVS VTAM Logic, SY28-0621 


The following publications are referenced for specific components: 


e Checkpoint/ restart - OS/VS2 MVS Checkpoint/ Restart, GC26-3877 
e¢ Dumping services - OS/VS2 MVS System Programming Library: 
Service Aids, GC28-0674 


« SMF - OS/VS System Management Facilities, 
GC28-1030 
« SRM - OS/VS2 System Programming Library: 
Initialization and Tuning Guide, GC28-1029 
e Virtual Fetch - OS/VS2 System Programming Library: Job 


Management, GC28-0627 
Note: These titles are sometimes used in abbreviated form in the text. 
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Summary of Amendments 


Summary of Amendments 
for LY28-1099-1 
MVS/System Product Release 3.3 


This edition incorporates changes to the module descriptions in support of 
MVS/System Product Release 3.3. 


Summary of Amendments 

for LY28-1099-0 

as Updated June 30, 1982 

by Technical Newsletter LN28-5021 


Module descriptions of new and changed modules for MVS System Product 
Release 3.2 have been updated. 


Summary of Amendments 

for LY28-1099-0 

as Updated December 30, 1981 

by Technical Newsletter LN28-4992 


This newsletter contains an updated module description of IELRPREAD. 


Summary of Amendments 
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Module Descriptions 


This section contains descriptions of the object 
modules that perform the scheduler and supervisor 
functions for the MVS operating system. The 
description of each object module includes: 


e Asummary of the operation of the module 

e The names of the modules that pass control to it 

¢« The names of the modules that receive control from 
it 


The module descriptions are arranged alphamerically 
by module name. If there are two names in a title, the 
first is the CSECT name and the second (in 
parentheses) is the assembler module name. If there is 
only one name in the title, it is the name of both the 
CSECT and the assembler module. 
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CSVVFCRE — Virtual Fetch Initialization Module 


Operation. CSVVFCRE builds the virtual fetch control 
block (VFCB) in the common service area (CSA) and 
sets up a cross memory environment for the virtual 
fetch service address space. CSVVFCRE then builds 
the virtual fetch hash table and the virtual fetch VIO 
data set. Using the data sets provided by the user, 
virtual fetch reformats and validates the directory 
entries (DEs) before placing them in the virtual fetch 
hash table. CSVVFCRE places the user-provided load 
modules into the VIO data set. When finished, each 
entry in the hash table contains the location of a load 
module in the VIO data set. CSVVFCRE is a 
never-ending task. CSVVFCRE enters a wait state 
until the operator either reexecutes CSVVFCRE (via a 
cross memory post from CSVVFRSH) or cancels 
CSVVFCRE. 


Entered through: Started task control. 

Exit to: None. 

Called routines: CSVVFCR1, IEAVAMSI, ILRGOS. 
CSVVFCR1 — Virtual Fetch Module Formatter 


Operation. CSVVFCRE calls CSVVFCR1 to reformat 
a load module that CSVVFCRE provides. 
CSVVFCRI reads the TXT records into a buffer. 
CSVVFCRI1 then reformats the TXT and RLD data 
and copies this data into the VIO window. 
CSVVFCRI converts the directory entry (DE) for this 
module into the virtual fetch hash table format and 
places the reformatted DE in the hash table. Since 
CSVVFCRE can access the window, CSVVFCR1 only 
returns a return code stating whether the reformatting 
was successful. 


Entry from: CSVVFCRE. 

Exit to: Caller. 

CSVVFGET — Virtual Fetch Module Obtain Routine 
Operation: Callers use CSVVFGET to bring a module 
into storage from virtual fetch’s read-only VIO data set 
and to pass control to the requested 

module. CSVVFGET validates the caller’s input, 
issues a call to CSVVFTCH to bring the module into 


storage, issues a SYNCH SVC to the module, and 
cleans up. 
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Entry from: 


For entry point CSVVFGET: Users of virtual 
fetch. 


For entry point COVVFRM: CSVVFIND, 
CSVVFTCH (to issue the FREEMAINs for 
module and VCBs storage). 


For entry point CSVVFGES: RTM. 
For entry point CSVVFRR: RTM. 
Exit to: Caller. 
Error exit. RTM 
Called routines: CSVVFIND, CSVVFTCH. 
CSVVFIND — Virtual Fetch BUILD and FIND Routine 


Operation: Callers use CSVVFIND to build a VFWK to 
represent a module accessible by virtual fetch. Callers 
also use CSVVFIND to determine if a VFWK exists 
and, if necessary, to initialize the VFWK. CSVVFIND 
validates the parameter list, performs initialization, and 
searches for the VFWK. If the caller requested the 
BUILD function and the VFWK already exists, 
CSVVFIND returns to the caller; if the VF WK does 
not exist, CSVVFIND creates one, initializes it, and 
chains it to the VF WK chain. If the caller requested 
the FIND function, CSVVFIND finds the VFWK and 
checks to see if the VFDE data in the VF WK needs to 
be refreshed. (CSVVFIND calls CSVVFSCH to 
perform the VFWK refresh operation.) 


Entry from: 


For entry point CSVVFIND: User of the virtual 
fetch service. 


For entry point COVVFORK: CSVVFGET, 
CSVVFIND. 


For entry point CSVVFFES: RTM. 
Exit to: Caller. 
Error exit. RT™. 


Called routines: CSVVFSCH, CSVVFGET. 
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CSVVFMEM — Virtual Fetch Memory Termination 
Manager 


Operation: During termination of the virtual fetch 
service address space, CSVVFMEM indicates in the 
VFCB that virtual fetch is not active. During 

- termination of job step task, CSVVFMEM clears the 
pointer in the ASXB (ASXBVFVT) to the virtual fetch 
control blocks, located in the user’s address space. 


Entry from: TEAVTMMT, IEAVTSKT. 
Exit to: Caller. 
CSVVFRSH — Virtual Fetch Refresh Module 


Operation. CSVVFRSH issues a cross memory post to 
CSVVFCRE to refresh the modules maintained by 
virtual fetch. If unable to issue the cross memory post 
(because a refresh is currently executing or virtual fetch 
is inactive), CSVVFRSH issues a WTO SVC (SVC 35) 
to inform the operator. 


Entry from: Dispatcher. 
Exit to: Caller. 
CSVVFSCH — Virtual Fetch Search Routine 


‘Note: CSVVFSCH and CSVVFCRE must be link 
edited into the same load module so that COVVFCRE 
is able to set up a cross memory entry table containing 
CSVVFSCH. 


Operation. CSVVFIND calls CSVVFSCH when it 
needs to refresh the VFDE data in a virtual fetch entry 
point work area (VFWK) in the user’s address space. 
(The VFWK is the local control block for a module 
maintained by virtual fetch.) CSVVFSCH searches the 
virtual fetch hash table for the virtual fetch directory 
entry (VFDE) for the requested module. If found, 
CSVVFSCH returns the VFDE data to CSVVFIND 
(in the user’s address space). CSVVFIND needs to call 
CSVVFSCH the first time it uses the FIND function 
and whenever the copy of the module located by the 
VFWK is obsolete and needs to be refreshed. 


Entry from: CSVVFIND. 


Exit to: Caller. 


CSVVFTCH — Module-obtain Routine for Virtual 
Fetch 


Operation. CSVVFGET calls CSVVFTCH to obtain a 
copy of a module. CSVVFTCH obtains sufficient 
storage for the module and the VIO control blocks 
(VCBs), initializes the CDE and extent list (XTLST) 
for the module, loads a fresh copy of the module from 
virtual fetch’s VIO data set, and relocates the module’s 
address constants (ADCONSs). 


Entry from: CSVVFGET. 
Exit to: Caller 
Called routines: TEAV AMSI. 


ICFBDF00 — PWF Machine Check Handler 
Appendage 
Operation: This module determines the severity of a 


power disturbance. If the power supply is in jeopardy, 
it transfers real storage to a disk. 


Entry from: IGFPMCIH at entry point ICFDBEO0O. 


Secondary entry point: ICFBDE99. This entry point is 
returned to by the user-provided code when a dump of 
real storage is warranted. 


Exit to: Disabled wait state if the power warning is 
serious; IGFPMCIH if the power warning is false, if 
the Power Warning Feature is not supported, or if 
requested by the user-provided code. 

IEAFTEED — EED Control Block Format Module 
Operation: This module formats the EED passed in the 
parameter list and summarizes the bit flags. It sends 
back a return code to its caller indicating failure or 
success in formatting. 

Entry from: IEAVTFMT. 

Exit to: Caller. 

IEAFTESA — ALIAS Entry in IEAFTRT2 


TEAFTFRR — ALIAS Entry in IEAFTIHS 
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IEAFTIHS — IHSA-FRRS Control Block Format 
Module 


Operation: This module formats the THSA or FRRS 
passed in the parameter list. It also formats the RT1W 
which is embedded in both the IHSA and FRRS. It 
then summarizes the bit flags from the RT1W and 
passes back the address of the EED pointed to by the 
RT1W. It also sends back a return code to its caller 
indicating failure or success in formatting. 


Entry from: TEAVTFMT at all entry points. 

Exit to: Caller. 

IEAFTRTC — ALIAS Entry in IEAFTSCB 
IEAFTRT2 — RTM2WA-ESA-SDWA Format Module 
Operation: This module formats the RTM2WA passed 
in the parameter list, summarizes the important fields 
of the RTM2WA, and summarizes the bit flags. It also 
summarizes the bit flags from the ESA of the related 
SVRB and the registers at the time of error from the 
SDWA. The RTM2WA entry point also returns the 
address of the related SVRB to the caller. Each entry 
point invoked sends a return code to its caller 
indicating success or failure in formatting. 

Entry from. TEAVTFMT at all entry points. 

Exit to: Caller. 


JEAFTSCB — SCB-RTCT Control Block Format 
Module 


Operation: This module formats the SCB or RTCT 
passed in the parameter list. It summarizes the bit flags 
in the SCB. It also sends a return code to its caller 
indicating success or failure. 

Entry from. IEAVTFMT at all entry points. 

Exit to: Caller. 

IEAFTSDW — ALIAS Entry in IEAFTRT2 
IEASMFEX — SMF EXCP Counter Routine 


Operation: This module is entered to count all EXCPs 
into the TCTIOT and the OUCB. 


Entry from: 1/O drivers. 


Exit to: Caller. 
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IEASMFSP — SMF Suspend/Reset Interface Module 


Operation: This module provides SMF with an interface 
to the suspend/reset functions residing in the nucleus. 
The entry code indicates which function is requested. 


Entry from: TEEMB830 (suspend), IEEMB825 (reset), 
TEEMB834 (reset). 


Exit to: Dispatcher, for suspend. Caller, for reset. 


Called routines: TEAVSUSQ, IEAVRSET (entry points 
in IEAVEPC, the PCFLIH). 


IEATLEXT — SMF Time Limit Extension 


Operation: This module is entered if a job, job step, or 
wait-time limit has expired. It interfaces with the SMF 
user’s exit routine, JEFUTL. If the exit grants an 
extension, IEATLEXT extends the expired limit by the 
amount specified by the exit. If the exit does not grant 
an extension, IEATLEXT will abend the expired task 
with a code 322 for a job or job step limit expiration, 
or 522 for a wait-time limit expiration. 


Entry from: Dispatcher (IEAVEDS0O). 

Exit to: Dispatcher (IEAVEDSO0). 

IEAV1052 — 1052 Console Device Support Processor 
Operation: This module performs the following 
functions for a 1052 printer-keyboard, 3210 console 
printer-keyboard, 3215 console printer-keyboard, or 
32 13 console printer used as a console: 


e Opens the device as a console. 


e Initiates a read operation to read a command from 
the console. 


e After a read operation completes successfully, 
passes the command to command processing (SVC 
34). 


e Initiates a write operation to write messages to the 
console. 


e After a write operation completes successfully, 
updates the console queue. 


e When the device is to be removed from console 
status, closes the console. 
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Entry from: TEAVVCTR. 
Exit to: 


¢ IEBAVSWCH if an I/O error occurs or the console — 
cannot be opened. 


e Issuer of SVC 72, otherwise. 

IEAV1443 — 1443 Console Device Support Processor 
Operation: This module performs the following 
functions for a 1443 printer, 1403 printer, or 3211 
printer used either as the output portion of a composite 
console or as an output-only console: 


e Opens the printer as an output console. 


- Uses BSAM to write WTO and WTOR messages to 
the console. 


e After a write operation completes successfully, 
updates the console. 


e When the printer is to be removed from console 
status, closes the console. 


Entry from: TEAVVCTR. 
Exit to: 


e IBAVSWCH if an I/O error occurs or the console 
cannot be opened. 


e Issuer of SVC 72, otherwise. 

IEAV2540 — 2540 Console Device Support Processor 

Operation: This module performs the following functions 

for a 2540 card reader punch, 2501 card reader, 2520 

card reader punch, 3505 card reader, or 3525 card 

punch used as the input portion of a composite console: 

e Opens the device as an input console. 

e« Uses BSAM to read a command from the console. 

e After a read operation completes successfully, 
passes the command to command processing (SVC 


34). 


e When the device is to be removed from console 
status, closes the console. 


Entry from: TEAVVCTR. 


Exit to: 


e IRAVSWCH if an I/O error occurs or the console 
cannot be opened. 


e Issuer of SVC 72, otherwise. 
IEAVADFM — User Formatter CSECT 


Operation: This module contains no executable code, 
only installation formatter names. 


Entry from: Not called. 
Exit to: Not applicable. 
IEAVADOA — Display SQA and LSQA 


Operation: This module displays the allocated SQA and 
LSQA. 


Entry from: IEAVAD01 via BALR. 
Exit to: IEAVADO1. 


IEAVADOB — Display LPA, JPA, and Active SVC 
Modules | 


Operation: This module conditionally displays those 
LPA/JPA modules that are on the active RB queue or 
load list of the task being dumped, and the active SVC | 
modules for the task. 

Entry from: TEAVAD0O1 via BALR. 

Exit to: Caller. 

IEAVADOC — Supervisor Trace Formatting 


Operation: This module displays the supervisor trace 
table. 


Entry from: TEAVADO1 via BALR. 
Exit to: Caller. 


IEAVADOD — Display Allocated Space Within User _ 
Subpools 


Operation: This module displays allocated space in user — 
subpools subpool 252. 


Entry from: TEAVAD01 via BALR. 
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Exit to: Caller. 

IEAVADOE — Display SWA 

Operation: This module displays allocated space in the 
SWA. This module is also called to display subpools 
229 and 230 when LSQA is requested. 

Entry from: TEAVAD0O1 via BALR. 

Exit to: Caller. 

IEAVADOF — Display SNAP 

Operation: This module displays the storage represented 
by the list supplied by the caller. This module also adds 
headers to the storage list if supplied by the user. 

Entry from: TEAVAD01 via BALR. 

Exit to: Caller. 

IEAVAD00 — SVC 51 

Operation: This module identifies the function 
requested (SNAP or SVC DUMP) and routes control 
to the corresponding routine. The SVC DUMP 
ROUTINE is contained in the module. 

Entry from: SVC TH. 

Exit to: Exit routine. 

Exit-error. Abend caller. 

IEAVAD01 — SNAP Mainline 

Operation: This module gets storage for, and initializes, 
buffers, and validity checks SNAP parameter list. It 
also routes control to the appropriate functional display 
routine, displays an index of the dump, and cleans up 
after all indicated areas have been displayed. 

Entry from: EAVADO0 via BALR. 

Exit to: TEAVADO00. 

IEAVAD02 -— Header, PSW Formatting 


Operation: This module formats and prints the dump 
_ ID, jobname, stepname, time, and completion code. 


Entry from: TEAVAD01 via BALR. 


Exit to: Caller. 
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IEAVAD03 — Control Blocks I 


Operation: This module formats and prints the ASCB, 


-TCB, RBS, LLES, CDES, extent lists, and the TIOT 


for the task being dumped.. 

Entry from: TEAVAD01 via BALR. 
Exit to: Caller. 

TEAVAD05 — Control Blocks II 


Operation: This module formats and displays the VMM 
blocks (SPQE, DQE, and FQEB), the IQE, POE, FBQE 
queues, and the TCB summary. 


Entry from: TEAVAD01 via BALR. 
Exit to: Caller. 
IEAVAD07 — Display Save Areas 


Operation: This module provides the display of user 
Save areas. 


Entry from: TEAVADO1 via BALR. 
Exit to: Caller. 


IEAVAD08 — SNAP, TCAM, GTF, VSAM, Shared 
Resources Interface Module, and Installation Formatters 


Operation: This module is responsible for the interfaces 
to the SNAP, TCAM, GTF, VSAM, shared resources 
formatting routines, and installation format routines. 


Entry from: TEAVAD01 via BALR. 


Exit to: TEAVAD01, IBGDSNAP via BALR for 
GRSQ, IDA0195A via BALR for VSAM, IGAOE0S5SA 
via LOAD and BALR for TCAM, IGCOFOSA via 
LOAD and BALR for GTF, IGCOS905A via LOAD 
and BALR for shared resources. ISTRAFD1 via 
LOAD and BALR for VTAM, and installation format 
routines whose names appear in the format CSECT, 
IEAVADFM via BALR. 


IEAVADO09 — Display Nucleus and PSA 


Operation: This module displays the control program 
nucleus and PSA. 


Entry from: TEAVD01 via BALR. 
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Exit to: Caller. 

IEAVAD10 — Display PSW and Registers 

Operation: This module conditionally formats and prints 
the PSW, ILC, and interruption code, and displays the 
registers at entry to SNAP or ABEND. 

Entry from: TEAVAD01 via BALR. 

Exit to: Caller. 

IEAVAD11 — SNAP Output Routines 


Operation: This module writes the lines of the dump on 
the output device. 


Entry point IEAVAD21 forces output of any 
records remaining in buffer after the dump is 
complete. 


Entry point EAVAD81 is the interface between 
the subsystem formatting routines and the output 
module IEAVAD11. 


Entry from: TEAVAD01 via BALR. 
Exit to: Caller. 
IEAVAD31 — SNAP Format and Format 01 Routines 


Operation: This module unpacks data into the output 
line while it associates a label with each piece of data. 


Entry point IEAVAD31 converts the data to 
decimal notation and unpacks it into the output line 
associating labels with the fields. It also allows an 
indentation factor to the location in an output line 
where the data is to be placed. 


Entry point IEAVAD41 performs the same 
functions as IEAVAD31 except that no indentation 
factor is anticipated in the layout line. 

Entry from: Caller via BALR. 

Exit to: Caller. 


_ Error exit. RTM via on x’0C4’ abend after an 
unexpected UPR occurs. 


IEAVADS51 — SNAP Format 20 and Format 22 
Routines 


Operation: Format 20 translates the line into printable 
characters and unpacks three bytes of data into the 
beginning of the line. Format 22 unpacks up to four 
bytes of data into any positions of the line. — 

Entry from: 


For entry point IEAVADS1 — format 20 routine: 
IEAVAD71 via BALR. 


For entry point IEAVAD61 — format 22 routine: 
IEAVAD71 via BALR. 


Exit to: TEAVAD71. 

Error exit: TEAVAD71 with register 15 set to 8. 
IEAVAD71 — SNAP Format Router 

Operation: This routine controls the routing of other 
format routines to produce the print line that consists 
of the address of the data, the hex representation, and 


the EBCDIC translation of the data at that location. 


Entry from: TEAVADO3, IEAVADOB, IEAVADOD via 
BALR. 


Exit to: Caller. 

Error exit: Caller with a return code of eight if the 
space for a save area is not available, or RTM with an 
X’0C4’ abend if an unexpected UPR occurs. 
IEAVAMSI — VIO Services Interface 

Operation: This module manipulates page and external 
page tables and page frame table entries (PFTEs) for 
the virtual block processor (VBP) in support of VIO 
data sets. 


Entry from: The virtual block processor (VBP). 


Exit to: VBP. 


IEAVARO00 — RCT Initialization/Termination 


Operation: This module performs address space 
initialization functions for a new address space and 
attaches the dump task and started task control. When 
a task terminates, this module frees address space 
resources before termination and detaches the dump 
task and the started task control task. 
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Entry from: 

For entry point IEAVARO0: IEAVEMIN. 

For entry point EAVAERO: IEAVTAS1. 
Exit to: Caller. 
IEAVARO1 — RCT Common Processing 
Operation. This modules routes control within the RCT 
modules to wait for a functional request in the quiesce 
module and passes control to other routines to perform 
the requested functions. These functions are performed 
until a termination request is received, this module then 
returns control. 
Entry from: 

For entry point EAVARO1: IEAVAROO. 

For entry point IEAVARIA: IEAVTRT2. 
Exit to: Caller. 
JIEAVARO2 — Quiesce Routine 
Operation: This module waits for a functional request to 
be posted and determines the function requested. If 
posted by SRM, this module either prepares an address 
for swap-out, or verifies that all tasks under the RCT 
are in long wait prior to returning. If a swap-out is 
possible, this module breaks active addressing binds to 
the address space and prohibits new ones. If posted for 
a termination or attention exit request, this module 
returns control. 
Entry from: 

For entry point IEAVARO2: IEAVARO1. 

For entry point EAVAFR2: IEAVTRTS. 
Exit to: Caller. 


Called routines: TEAVEBBR, IEAVESPM, 
IEAVSOUT, IEAVWATT. 


IEAVARO3 — Restore Routine 
Operation: This module either prepares an address 


space for execution after swap-in or handles quiesce 
backout processing. 
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Entry from: 
For entry point IEAVARO3: IEAVARO1. 
For entry point IEAVAR3A: IEAVTASI. 
For entry point IEAVAFR3: IEAVTRTS. . 
Exit to: 


For entry points IEAVARO3 and IEAVAR3A: 
TEAVARO1. 


For entry point IEAVAFR3: IEAVTRTS. 
IEAVARO4 — Attention Exit Scheduler Routine 
Operation: This module determines the attention level 
to be scheduled and schedules the associated attention 
exit. 

Entry from: 
For entry point EAVAR04: IEAVARO1. 
For entry point IEAVAFR4: IEAVTRTS. 
Exit to: Caller. 
IEAVARO5 — Attention Exit Prolog Routine 
Operation: This module acts as a front end of the user 
attention exit. It issues TPUT or TGET to the terminal, 


creates and initializes the TAJE, and goes to the 
attention exit in the user’s key and state. 


Entry from: 
For entry point EAVAROS: IEAVEDSO. 
For entry point EAVARTS: IEAVTRT2. 
For entry point EAVAFRS: IEAVTRTS. 
Exit to: 


For entry points IEAVAROS5 and IEAVARTS: 
User attention exit or IEAVEOR. 


For entry point EAVAFRS: Caller. 
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IEAVARO6 — Attention Exit Epilog Routine 
Operation: This module acts as a resource manager for 
the TAXE queue. It frees the TAIE, restarts the 
subtasks of the TCB for which the attention exit has 
completed, performs housekeeping on the TAXE 
queue, and updates the available TAXE count. 
Entry from: 

For entry point IEAVARO6: TEAVEOR. 

For entry point IEAVAFR6: IEAVTRTS. 
Exit to: Caller. 
IEAVARO7 — Attention Exit Purge Routine 
Operation: This module acts as a resource manager for 
the TAXE queue. It is entered at task termination time 
so that inactive TAXEs for the terminating TCB can be 
dequeued. In addition to the TAXE queue 
housekeeping, this module updates the available TAXE 
count. 
Entry from: 

For entry point IEAVARO7: IEAVTSKT. 

For entry point EAVAFR7: IEAVTRTS. 
Exit to: Caller. 
TEAVAX00 — STAX SVC Service Routine 
Operation: This routine creates, maintains, and releases 
terminal attention exit elements (TAXEs) which 
contain information for scheduling terminal attention 


exits. These TAXEs are queued from the Region 
Control Task Data Area (RCTD) as they are created. 


Entry from: 
For entry point IGCO009F: IEAVESVC. 
For entry point STXFRR: IEAVTRTS. 
Exit to: 
For entry point IGCOOO9F: IEAVEOR. 


For entry point STXFRR: Caller. 


IEAVBLDP — Build Quickcell Pool 


Operation: This module creates, extends, or recovers 
(reformats) a quick-cell pool. 


Entry from: TEABLDP. 
Exit to: Caller. 


IEAVCARR — Functional Recovery Routine for Module 
IEAVGCAS 


Operation: This module attempts to clean up and 
recover from the following error situations encountered 
in module IEAVGCAS: program checks, machine 
checks, abends, percolation from a subordinate FRR, 
and operator restarts. 


Entry from: 


For entry point IEAVFCARR, IEAVTTRR, and 
IEAVFARR: IEAVTRTS. 


Exit to: Caller. 

IEAVCKEY — Change Storage Key 

Operation. This module changes the storage key and 
fetch protection for virtual pages allocated from the 


problem program subpools. 


Entry from: A supervisor state routine executing under 
protection key zero by branch entry only. 


Exit to: Caller. 


IEAVCKRR — Functional Recovery Routine for module 
TEAVCKEY 


Operation: This module attempts to recover from 
program checks and machine checks encountered in 
module IEAVCKEY by restoring the original storage 
key of those pages changed. 

Entry from: RTM routine TEAVTRTS. 

Exit to: Caller. 

IEAVCSEG — Create Segment 


Operation: This module performs one of the following 
functions for one or more segments at a time: 


e Initializes a segment table entry and its associated 
page table 
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¢ Initializes a segment table entry and its associated 
page table, the external page table associated with 
the page table, and an entry in the SWAP control 
table (SPCT) for this segment 

Entry from: 


For entry point IEAVCSEG: IEAVNP08 and 
IEAVGMOO. 


For entry point EAVCSGB: IEAVEQR. 
Exit to: Caller. 
IEAVC700 — Communications Task Command Queuer 
Operation. This module queues a command for 
execution by the communications task, ensuring that 
the command executes in the communications task’s 
address space and under its TCB. After the command 
is processed, this module dequeues the command. 
Entry from: TEAVMQWR, JEE6703D. 
Exit to: Caller. 
IEAVDELP — Delete Quickcell Pool 


Operation: This module deletes all or part of a quickcell 
pool. 


Entry from: TEAVDELP. 
Exit to: Caller. 
JIEAVDLAS — Delete Address Space 
Operation: This module makes available real storage 
manager resources associated with a terminating 
address space. It also contains the SRB purge exit for 
all RSM SRBs. 
Entry from: 

For entry point EAVDLAS: IEAVTERM. 


For entry point IEAVSRBP: IEAVEPDO0 or 
TEAVTMMT. 


Exit to: Caller. 
IEAVDSEG — Destroy Segment 


Operation: This module destroys one segment table 
entry by invalidating it. 
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Entry from: TEAVRELS and IEAVEQR. 
Exit to: Caller. 


IEAVEAC0 — ASCB Dispatching Queue Manipulation 
Routine . 


Operation: This routine moves an ASCB to a new 
dispatching priority, adds an ASCB to a specified 
priority, or deletes a specified ASCB from the 
dispatching queue. 


Entry from: 


For.ertry point EAVEACO: Memory 
create/delete, SRM, and swap out/in. 


For entry point IEAVEAC3: RTM, for functional 
recovery routine processing. © 


Exit to: Caller. 
IEAVEATO — ATTACH Service Routine 


Operation: This module creates a new task as a subtask 
of an existing task. ATTACH can also set an indicator 
in a TCB for LINK, recover the TCB dispatching 
queue for RTM, and save error information for RTM 
when the ATTACH FRR has not yet been entered. 


Entry from: 


For entry point IGC0004B: SVC interrupt handler 
to create a TCB, an XSB, and an SVRB. 


For entry point IGC043R1: The dispatcher to 
obtain and initialize save area that LINK uses for 
the TCB being attached. 


For entry point IGC042R2: RTM to ensure that 
the FRR is in the correct address space and has not 
been used. 


For entry point IGC042ES: RTM to save error 
information in the SDWAVRA. 


Exit to: 
For entry point IGCO004B: Exit prolog to return 
control to the caller before reentering ATTACH at 
IGC042R1. 


For entry point IGC042R1: LINK (IEAQCS01). 
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For entry point IGC042R2: RTM. 

For entry point IGC042ES: RTM. 
IEAVEBBR — Bind Break Service Routine 
Operation: This module is called in two situations: 


e When a module changes the cross memory 
environment (the AX, LX, or LT) of an address 
space, it calls EAVEBBR to determine if the 
change made the cross memory environment of any 
online processor invalid. If it did, the unit of work 
on that processor is abended. If a processor’s cross 
memory environment is still valid, EAVEBBR 
ensures that the processor’s cross memory control 
registers contain current information. 


e When an address space can no longer be accessed 
in cross memory mode, the module handling the 
situation calls EAVEBBR to mark the address 
space invalid for cross memory access and to break 
all active binds to the address space. If any online 
processor’s primary or secondary address space is 
the same as the address space that is no longer 
accessible, the unit of work on that processor is 
abended. 


Entry from: 
For entry point IEAVEBBR: A module that 
changes the cross memory environment of an 
address space. 
For entry point IEAVEBB2: IEAVEES. 

Exit to: Caller. 


Called routines: TEEVEXSN and IEAVECMS at entry 
point IEAVLACB. 


IEAVECH0 — CHAP Service Routine 


Operation: This module alters the dispatching priority of 
a task. 


Entry from: SVCIH, at entry point IGC044. 


Exit to. EXIT prolog (IEAVEEXP) to force 
dispatcher-entry. 


IEAVECMS — CMSET Service Routine 


Operation: This module performs the following services 
to satisfy the macro indicated: 


e Establishes a specified address space as both the 
caller’s primary and secondary address space 
(CMSET SET) 


e Restores a previously existing cross memory 
environment (CMSET RESET) 


e Establishes a specified address space as the 
secondary address space, and puts the caller into 
secondary addressing mode (CMSET SSARTO) 


e« Restores the secondary address space and cross 
memory addressing mode that existed before an 
associated CMSET SSARTO macro executed 
(CMSET SSARBACK) 


e Locates the returns the address of an identified 
ASCB (LOCASCB) 


e Provides branch entry to the dispatcher 
(CALLDISP) 


Entry from: 


For entry point EAVCMS1: Issuer of a CMSET 
SET macro. 


For entry point IEAVCMRI: Issuer of a CMSET 
RESET, CHKAUTH= YES macro. 


For entry point EAVCMR2: Issuer of a CMSET 
RESET, CHKAUTH=NO macro. 


For entry point IEAVCMST: Issuer of a CMSET 
SSARTO macro. 


For entry point EAVCMSB: Issuer of a CMSET 
SSARBACK macro. 


For entry point IEAVLACB: Issuer of a 
LOCASCB macro. 


For entry point IEAVCDEN: Enabled issuer of a 
CALLDISP macro. 


For entry point IEAVCDDS: Disabled issuer of a 
CALLDISP macro. 
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Exit to: 


For all entry points except IEAVCDEN and 
IEAVCDDS: Caller by issuing a BR 14 instruction. 


For entry points EAVCDEN and IEAVCDDS: 
Dispatcher at entry point EAVODS1. 


Error exit. RT via an ABEND macro. 


IEAVEDR —— Interprocessor Communication Direct 
Signal Routine 


Operation: This module gives the interface needed to 
signal other processors that invoke any one of the © 
twelve functions of: sense, external call, emergency 
signal, start, stop, restart, initial program reset, program 
reset, stop and store status, initial microprogram load, 
Initial CPU reset, and CPU reset. 


Entry from: TEAVEDR via BALR. 


Exit to: TEAVEDR for normal exit; and to a System 
Termination Facility for abnormal exit. 


IEAVEDSR — Dispatcher Recovery 


Operation: This module calls the necessary functions to 
clean up dispatching queues and the processor in order 
to continue to dispatch ready work. 


Entry from: TEAVESPR. 


Exit to: TEAVERTN, return address in IEAVESPR 
(super FRR). 


IEAVEDS0O — Dispatcher 


Operation: This module dispatches tasks, local 
supervisor routines and SRBs. 


Entry from: 


For entry point IEAOQDS1 (general entry point): 
SVC FLIH, EXIT prolog, ACR, STATUS (status, 
stop, synch), and CALLDISP (type 6) when cross 
memory status has already been saved. 


For entry point EAODS (general entry point): 
CALLDISP (type 6) when cross memory status has 
not been saved. 


For entry point EAVDSPC: Program FLIH and 
lock manager (IEAVELK). 
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For entry point IEAVDSTC: IEAVETCL to 
dispatch a task. 


For entry point DDSRBRTN: SVC FLIH when a 
type 6 SVC exits and requests that control be given 
to an SRB. 


For entry point IEAPDS7: I/O and external FLIH 
when an unlocked task is being preempted. 


For entry point IEAPDS7A: I/O and external 
FLIH when a task that holds a lock is being 
preempted. 


For entry point IEAPDS7B: I/O and external 
FLIH when no status needs to be saved. 


For entry point IEAPDS7C: I/O and external 
FLIH when a task that holds a CML lock is being 
preempted. 


For entry point IEAPDSPT: All SRB routines. 
For entry point DSJSTCSR: SVC FLIH 
(IEAVESVC), timer SLIH (IEAVRTIO), EXIT 
(IGCC03), and SRB time limit initialization routine 
(IEAVRT03). 
Exit to. Global SRB/SSRB dispatcher, local 
SRB/SSRB dispatcher, local supervisor dispatcher, task 
dispatcher, or wait task dispatcher. 
Called routines: TEAVESCS5S, IEAOEF03, IEAVRSPN, 
IEAVEMS0, TRWT, TRSRB2, IEADISP1, IEADISP2, 
TEADISP3, IEAVRJLM. 
IEAVEED0 — DETACH service routine 
Operation: This module detaches a task and frees its 


resources such as the TCB and any associated program 
save areas. 


Entry from: 
For entry point IGC062: SVC IH. 


For entry point IGC062R1: Supervisor routine via 
branch entry. 


Exit to: 
For entry point IGC062: Caller via exit prolog. 


For entry point IGC062R1: Caller. 
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TEAVEEEP — IQE Purge Routine 


Operation: Removes the IQEs for the terminating task 
from the asynchronous exit queue. 


Entry from: End-of-task processing or ABEND 
processing. 


Exit to: Caller. 

IEAVEEER — Stage 3 Exit Effector Recovery Routine 
Operation: This module uses the queue verifier 
IEAVEQV0 to verify and correct the asynchronous 


exit queues. 


Entry from: Dispatcher recovery (IEAVEDSR), at 
entry point IEAVEEER. 


Exit. Caller via a BR14. 

IEAVEEEO — Stage 3 Exit Effector 

Operation: This module dequeues IQEs, RQEs, and 
SRBs from the asynchronous exit queues, and it also 
schedules the corresponding asynchronous exit by 
queueing the associated IRB to the TCB. 

Entry from: The dispatcher at entry point IEAOEFO3. 
Exit to: Caller via register 14. 


IEAVEEE2 — Asynchronous Exit Queue Handler 
(Stage 2) 


Operation: This module places on the correct queue a 
request to schedule an asynchronous exit. 


Entry from: A system routine that passes an TOE, SRB, 
or an RQE to IEAVEEE2. 


Exit to: Caller. 


IEAVEES — Emergency Signal Second Level Interrupt 
Handler 


Operation: This module receives control from the 
external FLIH and gives control to the appropriate 
receiving routine whenever emergency signal interrupt 
occurs. 


Entry from: IEAVEEXT by using a BALR 2, 10. 


Exit to: Caller. 


IEAVEEXP — EXIT Prolog Routine 


Operation: This routine performs exit functions for all 
SVC routines. 


e Atentry point IEAVEXPR it provides normal SVC 
exit functions for all SVC routines unless they are 
the last RB on the TCB. 

e Atentry point IEAVEXP1 it provides SVC 
routines the ability to enter the dispatcher after exit. 
processing. 

e At entry point IEAVEXP2, it provides SVC exit | 
functions for microcode assisted type-1 SVC 
routines using the cross memory facility. 

« Atentry point EXPEPAT6, it provides SVC exit 
functions for type-6 SVC routines which specify 
RETURN=CALLER. 

Entry from: 

For entry point IEAVEXPR: All SVC routines. 
For entry point IEAVEXP1: All SVC routines. 
For entry point IEAVEXP2: Microcode assisted _ 
type-1 SVC routines using the cross memory 


facility. 


For entry point EXPEPAT6: The SVC FLIH, 
TEAVESVC. 


Exit to: 


For entry point IEAVEXPR: Caller if this is not 
the last RB or to IEAVEOR if this is the last RB. 


For entry point IEAVEXP1: Dispatcher. 

For entry point EAVEXP2: Caller or dispatcher. 

For entry point EXPEPATS6: Caller or dispatcher. 
Called routines. TEAVESS, IEAVTSBP. 


IEAVEEXT — External First Level Interrupt Handler 
(FLIH) 


Operation: This interrupt handler routine saves the 


status of the interrupted program, and decides what 
kind of external interrupt occurred in order to give the 
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proper SLIH control. It decides whether to return to 
the interrupted program or to the dispatcher. 


Entry from: An external new PSW as a result of PSW 
‘switch caused by an external interrupt. 


Exit to: The interrupted task, SRB, or the dispatcher. 
TEAVEE1R — External FLIH Recovery Routine 1 


Operation: This module cleans up the external FLIH 
resources to allow ABEND to percolate the error. 


Entry from: Super FRR (IEAVESPR) if an error occurs 
during operation of the external FLIH. 


Exit to: RTM via an ABEND SVC. 
IEAVEE2R — External FLIH Recovery Routine 2 


Operation: This module cleans up the FLIH resources 
to allow ABEND to percolate the error. 


Entry from: Super FRR (IEAVESPR) if an error occurs 
during operation of a recursive entry into the external 
FLIH. 

Exit to: RTM via an ABEND SVC. 

IEAVEE3R — External FLIH Recovery Routine 3 


Operation: This module cleans up the external FLIH 
resources to allow ABEND to percolate the error. 


Entry from: Super FRR (IEAVESPR) if an error 
occurred during the processing of a 2nd level of 
recursion into the external FLIH. 


Exit to: RTM via an ABEND SVC. 

IEAVEFO00 — CIRB (Create IRB) 

Operation. This module acquires space for an IRB, 
formats it according to the input parameters, and 
returns its address to the caller. It might also acquire 
space for a work area, which is appended to the end of 
the IRB. 

Entry from: SVC interrupt handler (IEAVESVC). 


Exit to: If branch entered, the caller by issuing a BR14; 
if entered by ICAVESVC, EXIT prolog (IEAVEEXP). 
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IEAVEINT — Intersect Service Routine 


Operation: This module is called when a set request is 
made to obtain the local or global intersect, ensuring 
serialization with the dispatcher or when a reset request 
is made to release dispatcher serialization requirements. 


Entry from: 


For entry point JEAVEINT: INSECT macro via a 
BALR (for a local SET request) or via a BAL (for 
a global SET request). 


For entry point IEAVEINR: INSECT macro via a 
BALR (for a local intersect RESET request). 


For entry point IEAVINTR: IEAVTRTS via an 
LPSW instruction. 


Exit fo: Caller. 

Called routines. TEAVEXSN. 

IEAVEIO — I/O First Level Interruption Handler 
Operation: This module saves the status of the 
interrupted program, invokes IOS to process the 
interruption, and determines whether to return to the 


interrupted program or to the dispatcher. 


Entry from: 1/O new PSW as a result of a PSW switch 
caused by an I/O interrupt. 


Exit to: Interrupted task, SRB, or dispatcher. 


IEAVEIOR — I/O FLIH Recovery Routine 


Operation: This module makes the I/O FLIH recovery 
operable by clearing the I/O FLIH recursion indicator, 
allowing ABEND to percolate to one previous level of 
recovery. 


Entry from: Super FRR (IEAVESPR). 


Exit to: TEAVESVR at entry point IEAVEABD 
(common ABEND) via register 15. 


IEAVEIPR — IPC Functional Recovery Routine 


Operation: This module clears RISGNL buffers and 
indicators so that RISGNL can be invoked again. 


Entry from: TEAVTRTS. 


Exit to. RTM via BR14. 
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JEAVELCR — Low Core Refresh 


Operation. This module examines and correctly sets 
constants and addresses in selected system control 
blocks for continual system execution. 


Entry from: TEAVTRT1. 


Exit. Via BR14 to the lock manager verification 
(IEAVELKR). 


TEAVELK — SETLOCK Service Routine 


Operation: This module sets and releases the various 
system locks by manipulating the lockwords associated 
with them. Locking synchronizes and controls access to 
the serially reusable resources of the system. 


Entry from: A system routine that issued a SETLOCK 
macro instruction. 


Exit to: Caller. 
IEAVELKR — Lock Manager Verification 


Operation: This module corrects correlations between 
the locking hierarchy mask and the lock words. When a 
restart condition and a lock spin condition exists, it 
clears spin lockwords. 


Entry from: 


For entry point IEAVELKR: IEAVELCR to verify 
and reconstruct locks, the lock table, and the 
hierarchy mask. 


For entry point IEAVLKRR: Recovery routine for 
lock manager to determine if SETLOCK recovery 
is applicable, and if so, whether a retry or 
percolation situation exists. 


Exit to: 


For entry point IEAVELKR: RSM recovery 
routine (IEAVRELS). 


For entry point IEAVLKRR: RTM or ASVT 
reconstruction routine (IEAVVFRR). 


IEAVEMCR — Memory Create 
Operation: This module establishes memory 


addressability, enqueues the new ASCB, and schedules 
a service request on the service priority list. 


Entry from: IEDAY3 via XCTL, IEEVWAIT, 
TEEMB8381. 


Exit to: Caller. 

IEAVEMDL -—- Memory Delete 

Operation: This module dequeues the ASCB of the 
specified address space from the ASCB ready queue, 
informs SRM of the address space deletion, determines 
if the ASID can be reused, adds this ASCB to a queue 
of ASCBs waiting to be freed, and releases storage for 
all eligible ASCBs. 

Entry from: TEAVTMMT. 

Exit to: TEAVTMMT. 

Entry point MDLESTAE: This entry point frees any 
ASCBs on the queue of ASCBs waiting to be freed and 
page frees the storage for IEAVEMDL, if it is fixed. 
Entry from: RTM. 

Exit to: RTM. 

IEAVEMIN — Memory Initialization 

Operation: This module creates a dispatchable 
TCB/SVRB on an ASCB’s TCB ready queue. It also 
sets the SVRB to enter the program manager for 
linkage to the RCT. 

Entry from: TEAVEMCR. 

Exit to. TEAVAROO. 

IEAVEMRQ — Memory Request 

Operation: This module assigns an ASID for a new 
address space. It creates the ASCB and notifies the 
system resource manager that a new address space is 
being created. 

Entry from. TEEO803D, IEEMB881. 

Exit to: TEE0803D. 

IEAVEMS0 —- Memory Switch Routine 

Operation: This module notifies the dispatcher that it is 


to either switch to another address space or begin 
searching for work on the ASCB dispatching queue. 
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Entry from: Supervisor routines that recognize more 
work has been made ready. These include IEAVELK, 
IEAVECHO, IEAVESCO, or IEAVSYSO. 


Exit to: Caller. 


IEAVENQ1 — Queue Manipulation Routine See 
ISGGNQDQ. (IEAVENQ1 is an alias entry point for 
ISGGNQDQ.) 


IEAVEOR — Exit 


Operation. This module terminates the current RB or 
SPIE exit. In RB termination it also recognizes 
end-of-task and thereupon initiates and later terminates 
EOT processing. 


Entry from: User and system programs. 


Exit to: EXIT prolog via entry register 14 or by normal 
task termination via SVC 13. 


Called routines: TEAVSETS, IEAVESSE, IEAVEBBR, 
TEAVTSBP, IEAPPGMX, IEAVESS, IEAQSPET, 
IGC062R1. 


IEAVEPCO — DAT—off Section of the Program First 
Level Interrupt Handler (FLIH) 


Operation: After a program check occurs, the program 
FLIH receives control from the program check new 
PSW. It determines the program check type and routes 
control to the appropriate second level interrupt 
handler to process it. The program FLIH’s code is 
located in two modules: IEAVEPO, which executes 
with DAT disabled and without virtual addressing, and 
IEAVEPC, which executes with DAT enabled. While 
performing the program FLIH functions, the two — 
modules pass control back and forth using an LPSW 
instruction. 


Entry from: Program check new PSW at entry point 
TEAQPKOO0. 


Exit to: 

e Interrupted program by issuing an LPSW 
instruction. This exit is used when the interrupt 
was: | 
— A PER or space switch interrupt and 


IEAVTPER did not request that the program 
be terminated 
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— A page fault and the paging supervisor was able 
to satisfy the page fault without I/O 


— A recursive PER or space switch interrupt. 


e The dispatcher at entry point IEAODS when the 
program FLIH scheduled an SRB to perform 
PIE/PICA processing 


e The dispatcher at entry point IEAVDSPC when a 
page exception has occurred and the paging 
supervisor has indicated that I/O is to be done. 


e IEAVTRT1 at entry point PROGCK in these 
situations: 


— A PER or space switch interrupt occurred and 
IEAVTPER requested that the program be 
terminated 


— A program check interrupt occurred and there 
was no active SPIE environment 


— An addressing exception, invalid page fault, 
unexpected error in RSM, or a translation 
specification exception occurred. 

e Super SPIE routine when a page exception has 
occurred and the interrupted program has an active 
super SPIE 


Error exit: TEAVTRT1 at entry point PROGCK, 
IEAVTRTI at entry point DATERR, or IGFPTERM. 


Called routines: TEAVEXMS. 


IEAVEPC — DAT—on Section of the Program First 
Level Interrupt Handler (FLIH) 


Operation: The program FLIH’s operation is described 
in the module description for IEAVEPCO. 


Entry from: The DAT-off section of the program FLIH 
at entry point IEAVPCON. 


Exit to: See the module description for EAVEPCO. 
Error exit. See the module description for EAVEPCO. 
Called routines: AHLMCIH, IEAVDSPC, IEAODS, 


TEAVPSRB, IEAVSPER, IEAVPIX2, IEAVTPER, 
IEAVTRT1, IEAVESCO, and IEAVECMS. 
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IEAVEPCR — Program FLIH Recovery Routine 


Operation: This module clears recursion indicators and 
allows percolation of recovery. 


Entry from. Super FRR (IEAVESRR) for recovery of 
program check FLIH, program interrupt handler 
(IEAVEAC), or IEAVEPCO. 

Exit to: RTM via on ABEND SVC. 

IEAVEPDR — PURGEDQ Recovery Routine 


Operation: This module performs FRR and ESTAE 
functions for PURGEDQ and itself. 


Entry from: 


For entry point IEAVEPDF: FRR for PURGEDQ, 
which handles errors during queue manipulation or 


scanning in PURGEDQ. 


For entry point IEAVEPDE: ESTAE for 
PURGEDQ 


For entry point IEAVEPDS: Retry routine for 
PURGEDQ. 


Exit to: 
For entry point IEAVEPDE: RTM via BALR. 
For entry point IEAVEPDF: RTM via BALR. 


For entry point IEAVEPDS: PURGEDQ at main 
entry point IGC123. 


IEAVEPD0 — PURGEDQ Service Routine 
Operation: This routine removes specified SRBs from 
the service manager queues. It ensures that the 
suspended SRBs have completed their processing 
before dequeueing them. 

Entry from: A supervisor routine. 

Exit to: Caller. 

TIEAVEQR — V=R Allocation 


Operation: This module allocates and frees contiguous 
real storage for use in V=R regions. 


Entry from: 


For entry points IEAVEQR and IEAVEQORF: 
IEAVPRTO. 


For entry point IEAVEQRI: IEAVPFTE. 


For entry point IEAVEQRC: IEAVEQRI and 
IEAVSQA. 


For entry point EAVEQRP: For SRB page-out. 
Exit to: Caller. 
Error exit: 

From entry point IEAVEQRC: IEAVRCV. 


From entry point IEAVEQRP: IEAVRCV or 
IEAVRMT. 


IEAVEQV0 — Queue Verifier 


Operation. The queue verifier (QV) verifies and 
corrects queue structures. It performs three basic 
functions: 


e If the queue structure has been destroyed, QV 
reconstructs the queue from any available 
information. 


e Once the queue structure has been verified or 
reconstructed, QV will remove any elements that 
contain bad data. 


e Records all detected errors, and corrective actions 
taken in an output data area. : 


Entry from: 


For entry point IEAVEQVI: Supervisor recovery 
routines for single-threaded queue with header only 
(type 1). 

For entry point IEAVEQV2: Supervisor recovery 
routines for single-threaded queue with header and 
trailer (type 2). 


For entry point IEAVEQV3: Supervisor recovery 
routines for double-threaded queue (type 3). 


Exit to: Caller. 
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IEAVERER — Restart IH Recovery Routine 


Operation: This module makes the restart FLIH 
recovery function operable. 


Entry from: Super FRR (IEAVESPR) at entry point 
IEAVERER. 


Exit to: TEAVESVR at entry point IEAVEABD to issue 
an abend. 


IEAVERES — Restart Interrupt Handler 


Operation: This entry saves the status of the interrupted 
program and proceeds to restart FLIH extension 
(IEAVEREX). 


Entry from: The restart new PSW. 


Exit to: RTM via IEAVEREX or resume interrupted 
program. 


Called routines: TEAVEREX. 
JEAVEREX — Restart FLIH Extension 


Operation: This module processes the restart interrupt 
fielded by EAVERES. Processing includes handling 
the operator-selected restart reason on processor 
consoles that support the restart reason function. 
Depending on the selected reason, this module: 


e Abends the interrupted program after displaying 
job information to the operator for verification. 


e Performs high-level system diagnosis and repair in 
the following areas: 


system nondispatchability 

exhausted WTO buffer elements 

no active batch or TSO jobs 

I/O problems (via EACVRSTS) 
Entry from: TEAVERES. 


Exit to: TEAVERES to resume interrupted work, RTM 
if interrupted work is to be abended. 


Called routines: TEEVDCCR, IEAVSETS. 
Entry point: TEAVERXI (this entry point is a 


non-executable text string to be displayed on processor 
consoles that support the restart text function. A 
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pointer to this entry point is contained in the CVT 
(CVTRESTX). IPL/NIP and VARY CPU, ONLINE 
interface with the console and pass this text.) 


IEAVERI — Interprocessor Communication Remote 
Immediate Service Routine 


Operation: This module gives the interface needed to 
signal other processors. It is used to invoke a specific 
program on any of the online MP-configured 
processors. It generates an emergency signal to the 
specified processor which then routes control to the 
specified program. 


Entry from: RISGNL macro via BALR. 
Exit to: Caller for normal exit. 


IEAVERP — Interprocessor Communication Remote 
Pendable Service Routine 


Operation: This module gives the necessary interface to 
signal other processors. It is used to invoke a specific 
program on any of the online 


MP-configured processors; it generates an external call 
to the specified processor, which will then routes 
control to the specific program. 

Entry from: RPSGNL macro via BALR. 

Exit to: Caller for normal exit. 

IEAVESCR — SCHEDULE Recovery Routine 
Operation: This module: 


e Verifies the SRB journal queue and reschedules any 
remaining SRBs. 


e Uses the queue verifier (IEAVEQV0O) to verify the 
GSPL and LSPL queues for every address space in 
the system. 


Entry from: 


For entry point IEAVESCR: Dispatcher recovery 
(IEAVEDSR) to clean up for the module 
(IEAVESC0). 


For entry point IEAVESQV: PURGEDQ FRR 
(IEAVEPDR) for queue verification. 
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Exit to: 
For entry point EAVESCR: Dispatcher recovery. 
For entry point EAVESQV: PURGEDQ FRR. 
IEAVESCO — SCHEDULE Service Routine 
Operation: For local SRBs, the SRB is placed on the 
appropriate queue, a waiting processor is signalled, and 
the system resource manager is invoked when work has 
become ready for an address space that is swapped out. 


For global SRBs, it is entered only if there is a waiting 
processor. 


Entry from: 


For entry point EAVESC1: Issuer of a local 
enabled SCHEDULE macro. 


For entry point IEAVESC2: Issuer of a local 
disabled SCHEDULE macro or IEAVESC1. 


For entry point IEAVESC3: Issuer of an enabled 
global SCHEDULE macro. 


For entry point IEAVESC4: Issuer of a disabled 
global SCHEDULE macro or IEAVESC3. 


For entry point IEAVESCS: Dispatcher 
(IEAVEDSO). 


For entry point IEAVESC6: Lock manager 
(TIEAVELK). 


Exit to: 
For entry point IEAVESC1: IEAVESC2. 


For entry points IEAVESC2, IEAVESC4, 
IEAVESCS, and IEAVESC6: Caller. 


For entry point IEAVESC3: IEAVESC4. 
Error exit: RTM via an ABEND macro. 
Called routines: TEAVEMSO. 
IEAVESPI — SPIE SRB Routine 
Operation: After a program check has occurred for an | 
unlocked task with a SPIE routine, IEAVESPI receives 
control to initialize a TCB/RB and a PIE to enter the 


SPIE routine. IEAVESPI marks the task dispatchable 
and IEAVEDS0O later dispatches it. 


Entry from: An SRB scheduled by IEAVEPC. 
Exit to: Dispatcher (IEAVEDSO). 
IEAVESPM — SRB/SSRB Pool Manager 


Operation. IEAVESPM processes four macros, 
GETSRB, GETSSRB, FREESRB, and FREESSRB. 
Depending on which macro is issued. IEAVESPM: 


e Obtains an SRB and a six-word parameter area 
from the SRB pool in subpool 245. If the pool is 
empty and the caller specified the UNCOND or 
EXPAND option, IEAVESPM either expands the 
pool or uses GETMAIN to obtain a single SRB and 
parameter area (GETSRB). IEAVESPM also 
initializes the SRB. 


e Obtains and initializes an SSRB and XSB from the 
SSRB pool in subpool 239. If the pool is empty and 
the caller specified the UNCOND or EXPAND 
option, IEAVESPM either expands the pool or 
uses GETMAIN to obtain a single SSRB/XSB 
(GETSSRB). 


e Frees an SRB and its associated parameter area. If 
IEAVESPM obtained the storage from the SRB 
pool, it returns the storage to the pool. Otherwise, 
IEAVESPM used GETMAIN when obtaining the 
storage, so it frees the storage (FREESRB). 


e Either returns an SSRB/XSB to the SSRB pool, or 


frees the storage (FREESSRB). (See the above 
explanation.) 


Entry from: 


For entry point EAVSPM1: A GETSRB macro via 
a BALR 14, 15 instruction. 


For entry point IEAVSPM2: A GETSSRB macro 
via a BALR 14, 15 instruction. 


For entry point IEAVSPM3: A FREESRB macro 
via a BALR 14, 15 instruction. 


For entry point IEAVSPM4: A FREESSRB macro 
via a BALR 14,1 5 instruction. 


For entry point IEAVEFRE: PURGEDQ to free 
the storage allocated for an SSRB/XSB. 
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For entry point IEAVSPMR (the FRR routine): 
RTM to repair the SRB and SSRB pools and 
release the SALLOC lock (if held). 


Exit to: Caller. 

Error exit: RTM via an ABEND macro. 

Called routines: Lock manager (IEAVELK), 
GETMAIN/FREEMAIN (IEAVGM00), and queue 
verifier (TEA VEQV0O).. 

IEAVESPR — Supervisor Control FRR (Super FRR) 
Operation: This module is a router routine for 
supervisor control. It determines retry and recovery 


addresses. In particular it can cause control to be 
routed to: 


Function Module name 
Restart FLIH recovery IEAVERER 
Program FLIH recovery IEAVEPCR 
External FLIH 1 recovery IEAVEEIR 
External FLIH 2 recovery TEAVEE2R 
External FLIH 3 recovery IEAVEE3R 

I/O FLIH recovery IEAVEIOR 

SVC FLIH recovery IEAVESVR 
Dispatcher mainline IEAODS (default) 
Entry from: 


For entry point IEAVESPR: RTM for recovery 
control by means of an LPSW, if an error occurred 
while one of the supervisor control FRR stacks was 
in control. 


For entry point EAVERTN: Mainline EAVESPR. 


Exit to: RTM, which will route control to one of the 
functions mentioned above. 


_ IEAVESRT — STOP/RESET Service Routine 


Operation: This module saves the status and performs 
the functions necessary to suspend a task or an SRB, | 
and restores the status and performs the functions 
necessary to make a suspended task or SRB 
redispatchable. 


Entry from: 


For entry point IEAVSUSP: Paging supervisor to 
stop a task or SRB. 


For entry point IEAVSUSQ: From a disabled 
routine to stop a task or SRB. 
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For entry point IEAVRSTD: From a disabled 
routine to make a stopped task or SRB 
redispatchable. 


For entry point IEAVRSET: From the paging 
supervisor to make a stopped task or SRB 
redispatchable. 


For entry point STOPFRR: RTM (IEAVTRT1). 
For entry point RESETFRR: RTM (IEAVTRT1). 
Exit to: Caller. 
Error exit. RTM via an ABEND macro. 
Called routines: TEAVEMSO. 
IEAVESSE — Space Switch Event Mask Manager 


Operation: This module enables and disables the space 
switch event mask (ASTESSEM) contained in the 
address space second table (ASTE). When the mask is 
enabled, a space switch program interrupt occurs 
whenever a program call (PC) or program transfer 
(PT) instruction switches addressability to or from an 
address space. There is one mask per address space, 
and several users per mask. Each user has a bit in the 
space switch ownership word (ASCBSSOM), which, 
when on, indicates that the associated user requires that 
the mask be enabled. EAVESSBP’s caller indicates 
which bit is to be set or cleared. After IEAVESSE 
updates the ownership word, it checks whether any 
users still require an enabled mask. EAVESSE then 
either disables the EVENT mask by setting it to zero, 
or enables it by setting it to one. 


Entry from: 


For entry point IEAVESSE: IEAVTSSH, 
IEAVTLCL and IEAVEOR. 


Exit to: Caller. 


Error exit: RTM via an ABEND macro (completion 
code X’058’) when the input ASID is invalid, the input 
index into the ownership word is invalid, or the 
reserved bits in the input registers are not zero. 


Called routines: TEAVECMS at entry point 
IEAVLACB (LOCASCB). 
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IEAVESSI — Service Routine that Sets Data in, or 
Obtains Data from an Entry in the Subsystem Affinity 
Table 


Operation: This module sets a data word or obtains the 
data word from a specified entry in a TCB’s subsystem 
affinity table (SSAT). 


Entry from: 


For entry point IEAVESAS: Issuer of a SSAFF 
SET macro. 


For entry point IEAVESAF: Issuer of a SSAFF 
OBTAIN macro. 


Exit to: Caller. 
Error exit. RTM via an ABEND macro. 


Called routines: TCB treescan routine in IEAVSETS 
(IEATRSCN), IEAVELK. 


IEAVESTS — SRB Status 
SAVE/RESTORE/MODIFY Routine 


Operation: TEAVESTS processes SRBSTAT macros. 
Depending on whether the macro specifies SAVE, 
RESTORE, or MODIFY, IEAVESTS: 


e Saves the current status or an SRB in a specified 
SRB status save area Cay: The saved status 
includes: 


— General purpose and floating point registers 
— Processor and SRB timing information 

— Processor affinity 

— The purge ASID and the purge TCB address 
— The PCLINK stack header 

— Cross memory status 

— The normal FRR stack 


If the caller provided the address of an FRR 
routine, IEAVESTS also adds the FRR to the 
- normal FRR stack. (SRBSTAT SAVE) 


e Restores status from values saved in a specified 
STSV. (SRBSTAT RESTORE) — 


e Stores a new purge ASID and purge TCB address 
in either the STSV or the LCCA. (SRBSTAT 
MODIFY) 


Entry from: 


For entry point IEAVESTS: An SRBSTAT SAVE 
macro via a BALR 14, 15 instruction. 


For entry point IEAVESTR: An SRBSTAT 
RESTORE macro via a BALR 14, 15 instruction. 


For entry point EAVESTM: An SRBSTAT 
MODIFY macro via a BALR 14,1 5 instruction. 


Exit to: Caller. 

Error exit: RTM via an ABEND macro. 

IEAVESVC — SVC First Level Interrupt Handler 
Operation: The SVC interrupt handler decides whether 
the issuer can issue SVCs, if the issuer is authorized, 
and what type of SVC requested. It also sets up the 


proper input environment for the SVC routine. 


Entry from: SVC new PSW as a result of a PSW switch 
caused by issuing an SVC instruction. 


Exit to. RTM (SVCERR), SVC routine. 

Error exit: SVC 13, EAVEXPR (EXIT prolog). 
IEAVESVR — SVC IH Recovery Routine 

Operation: This module performs two major functions: 


e It makes the SVC FLIH recovery operable by 
clearing the recursion indicator. 


e It issues ABENDs for SVC, I/O FLIMs. 
Entry from: 
For entry point IEAVESVR: Super FRR 
(IEAVESPR) if an error occurred during the 
operation of SVC FLIH. 


For entry point IEAVEABD: SVC FLIH recovery 
routine, I/O FLIH recovery routine (IEAVIOR). 


Exit to: 


For entry point IEAVESVR: Falls through to entry 
point IEAVEABD. 


For entry point EAVEABD: ABEND. 
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IEAVETCL — SUSPEND/RESUME/TCTL Processor 


Operation: This module contains the routines that 
suspend a TCB/RB, resume a TCB/RB, and transfer 
control to a TCB/RB. 

Entry from: 


For entry point IEAVSPND: Issuer of a SUSPEND 
macro. 


For entry point IEAVRSUH: Issuer of an 
unconditional synchronous RESUME macro. 


For entry point IEAVPSUS: Issuer of an 
unconditional synchronous RESUME macro in a 
specified address space. 


For entry point IEAVPSUA: Issuer of an 
unconditional asynchronous RESUME macro. 


For entry point IEAVRSCS: Issuer of a conditional 
synchronous RESUME macro. 


For entry point IEAVRSCA: Issuer of a conditional 
asynchronous RESUME macro. 


For entry point IEAVTCTL: Issuer of a TCTL 
macro. 


For entry point IEAVFTCR: RTM. 
Exit to: Caller. 
Error exit: RTM via an ABEND macro. 
Called routines: TEAVEMS0 and IEAVEDSO. 
TEAVEVAL — Validity Check 
Operation. This module validates an address or address 
range by determining if the storage key and the protect 
key match. 
Entry from: Supervisor routines via branch. 


Exit to: Caller. 


IEAVEVRR — ASVT and AFT Verification and 
Reconstruction Routine 


Operation: This module rebuilds the real address space 


first table (AFT) from the virtual AFT and restores 
control register 14 (the pointer to the real AFT). It 


11-22 OS/VS2 System Logie Library Volume 11 


Licensed Material — Property of IBM 


then checks for invalid entries in the ASVT and, if any 
exist, rebuilds the ASVT. 


Entry from: 


For entry point IEAVEVRR: RSM recovery 
routine (IEAVRELS). 


For entry point EAVVFRR: Lock repair routine’s 
FRR (IEAVLKRR). 


Exit to. RT. 
IEAVEVT0O — EVENTS Service Routine 
Operation: This module performs three services: 


e Event table creation and deletion, which causes an 
event table to be queued or dequeued from the 
requesting TCB. 


¢« ECB initialization, which causes the ECB to be 
initialized to the event format. If the ECB is: 
already posted, IEAVEVTO adds the ECB address 
to the event list of completed ECBs. 


e Event table wait, which causes the caller to stop 
processing and wait for the completion of one of n 
events. 


Entry from: 
For entry point EAVEVTO: Supervisor using 
branch entry to perform WAIT and/or ECB 
initialization. 


For entry point IGC125: SVC interrupt handler to 
perform WAIT and/or ECB initialization. 


For entry point IEAVEVT1: SVC interrupt handler 
through the type 2 extended SVC router to 
perform event table creation or deletion. 


Exit to: 


For entry point IEAVEVTO: Dispatcher (IEAODS) 
or caller. 


For entry point IGC125: EXIT prolog or ABEND. 


For entry point IEAVEVT1: EXIT prolog or 
ABEND. 
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IEAVEXMS —- Cross Memory Second Level Interrupt 
Handler 


Operation. When an X’0C1’ or an X’0C2’ program 
interrupt occurs, the program FLIH (IEAVEPC) 
branches to this module. If a processor without cross 
memory hardware installed caused the interrupt by 
issuing a cross memory instruction, IEAVEXMS routes 
control to the appropriate simulation subroutine to 
simulate the instruction. Otherwise, it returns to 
IEAVEPC, which handles the interrupt. 


Entry from: 
For entry point IEAVEXM1: IEAVEPCO. 


For entry point IEAVEXM2: IEAVEPCO when a 
recursive program interrupt occurs. 


Exit to: Interrupted program. 
Error exit: TEAVEPCO. 


Called routines: TEAVEPC, IEAVELK, and 
IEEVEXSN. 


IEAVEXS — External Call Second Level Interrupt 
Handler : 


Operation: Upon an external call interruption, this 
module receives control from the external FLIJH. It 
routes control to the appropriate receiving routine. 
Entry from: External FLIH via BALR 2, 10. 
Exit to: Caller. 
IEAVFP — Find Page 
Operation: This module returns the virtual addresses of 
the page and external page table entries corresponding 
to the input virtual address provided. 
Entry from: 
For entry point IEAVFP1: Non-RSM routines. 
For entry point IEAVFP2: Other RSM routines. 
Exit to: Caller. 
IEAVFRCL — FREECELL Routine 


Operation. This module returns a cell to the quickcell 
pool. 


Entry from: A routine that has no further need for 


allocated quickcell. 


Exit to: Caller. 
JIEAVFREE — PGFREE 


Operation: This module executes a PGFREE request or 
backs out a partially completed PGFIX request that is 
being cancelled. 


Entry from: 


For entry point IEAVFREE: IEAVFXLD, 
IEAVPSI. 


For entry point IEAVANYW: IEAVPSI. 
Exit to: Caller. 
IEAVFRLK — Lock Freeing Routine 


Operation: Depending on whether the processor holds 
the dispatcher or the local lock, this module clears 
either the global or local intersect in the SVT. It then 
releases all locks held by the caller. If the current task 
is the target of an earlier status request that could not 
be completed until a CML lock was released, 
IEAVFRLK calls the STATUS routine (entry point 
IGC07904 in IEAVSETS) to complete the pending 
status request. 


Entry from: A caller in supervisor state, zero protect 
key. 


Exit to: Caller. 
IEAVLKRM — Lock Resource Manager 


Operation. When an address space is being terminated, 
this module receives control either to: 


e Release any CML locks owned by the terminating 
address space (entry point EAVLKRM) 


e Reschedule any SRBs or SSRBs on the local lock 
SRB suspend queue. This puts the SRB/SSRBs 
back on the local or global SPLs so that the 
PURGEDQ routine finds them and calls their 
respective resource termination managers (entry 
point IEAVELRM). 
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Entry from: — 


For entry point EAVLKRM: RT memory 
termination processing. 


For entry point IEAVELRM: RTM. 

For entry point LKRMFRR: RTM. 
Exit to: Caller. 
Error exit. RTM via an ABEND macro. 
Called routines: TEAVESCO0: 
IEAVFXLD — Page Fix/Page Load 
Operation: This module brings virtual storage pages into 
real storage if they are not already there. For PGFIX 
requests, it fixes the pages in real storage so that no 
paging I/O will be performed for them. 
Entry point: TEAVFXLD from IEAVPSI. 
Exit to: TEAVPSI. 
Entry point: TEAVFXL from any RSM routine that 
decreases the PCB count in a PGFIX or PGLOAD root 
PCB to zero. 
Exit to: Caller. 


IEAVGCAS — Create/Free Address Space Routine, 
VSM Task Termination Routine 


Operation: This routine establishes addressability for a 
new address space, frees task-related storage at task 
termination, and frees VSM global storage at address 
space termination. 
Entry from: 

For entry point IEAVGCAS: IEAVEMCR. 

For entry point EAQSPET: IEAVEQR. 

For entry point IEAVGFAS: IEAVTSKT. 


Exit to: Caller. 
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IEAVGFA — General Frame Allocation 


Operation: This module performs real frame allocation 
services, including reclamation. Paging I/O is started 
where necessary to retrieve an auxiliary storage copy of 
a page. 


Entry from: 


For entry point IEAVGFA: IEAVPIX, 
IEAVFXLD, IEAVSWIN, or IEAVGFD2. 


IEAVGFAX — General Frame Allocation Extension 


Operation: This module contains many service routines 
called by IEAVGFA and IEAVSOQA (as well as other 
routines in IEAVGFAX) for frame allocation. 


Entry from: 


For entry point IEAVAIAL: IEAVGFA and 
IEAVS1BK to dispose of PCBs on an ASM I/O | 
request area (AIA) chain. 


For entry point IEAVCPCB: IEAVGFA to copy a 
PCB to another PCB. 


For entry point IEAVEQRS: IEAVGFA and 
IEAVSQA to find the best V=R frame on the 
AFQ that is below the 16 megabyte (Mb) line. 


For entry point IEAVFIXC: IEAVGFA and 
IEAVGFRAM to update the PFTE fix count and 
the system counts of fixed pages. 


For entry point EAVFRAM: IEAVGFA to 
associate a page and a frame. 


For entry point EAVFXBK: IEAVGFA and 
IEAVRELA to end a fix request that could not be 
satisfied. 


For entry point IEAVGFD2: IEABPFTE via 
IEAVEDS0 to drive allocation for deferred 
requests. 


For entry point IEAVPCPY: IEAVGFA and 
IEAVSQA to copy a page from one frame to 
another. 


For entry point IEAVPDIS: IEAVGFA to dispose 
of a PCB for an immediate allocation. 


For entry point IEAVPEX: IEAVGFA to exchange 
the contents of two frames. 
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For entry point IEAVPGIN: IEAVGFA to queue a 
PCB awaiting start of a page-in. 


For entry point IEAVPUTD: IEAVGFA, 
IEAVAIAL, IEAVFXBK and IEAVS1BK to put a 
PCB on the GFA defer queue. 


For entry point IEAVRELA: IEABGFA to relate a 
PCB to queued requests. 


For entry point IEAVRSMG: ERBMFETR to 
count the number of pageable pages below 16Mb 
that are good candidates for residence above Mb. 


For entry point IEABRSMS: IEAVGFA, 
IEAVPUTD and IEAVRELA to suspend a unit of 
work and remember its identity. 


For entry point IEAVS1BK: IEAVGFA to back 
out a failed stage 1 swap-in request. 


Exit to: 
For entry point IEAVGFD2: IEAVEDSO. 
For all other entry points: Caller. 


IEAVGFRR — Functional Recovery Routine for 
GETMAIN/FREEMAIN 


Operation: This module recovers the function of 
GETMAIN/FREEMAIN after a machine or system. 
error occurs. 


Entry from: IEAVTRTS. 
Exit to. TEAVTRTS. 


IEAVGM00 — GETMAIN/FREEMAIN Service 
Routine 


Operation: This module allocates (GETMAIN) and 
deallocates (FREEMAIN) virtual storage in the SWA 
and CSA and in the LSQA, SWA, and user region of 
each address space. A secondary function in support of 
system management facilities (SMF) is to produce 
actual storage-used values. 


Entries: 
CBBRANCH — for register type GETMAIN or 
FREEMAIN of a 16 byte cell from VSM control 
block cell pool. 


GMBRANCH — for storage type GETMAIN. 


FMBRANCH — for storage type FREEMAIN. 


GLBRANCH — for register type GETMAIN or 
FREEMAIN of global subpools without local lock. 


IEAVGMB — obtains storage for page tables. 
IEAVGME — expands a VSM cell pool. 
IEAVGMFB — frees space for page tables. 
GSMFCRE — updates SMF accounting fields. 


IEAVGMWP — puts the system in a wait when 
storage is not available for a global cell pool. 


Entry from: 


For entry point IGC004: IEAVESVC for storage 
type GETMAIN. | 


For entry point IGC005: IEAVESVC for register 
type, unconditional GETMAIN or FREEMAIN. 


For entry point GETMAING: IEAVPRTO0. 

For entry point MRELEASF: IEAVPRTO. 

For entry point MRELEASR: IEAVRELS. 

For entry points IEAVGMSA, IEAVGMSU, 
IEAVGMGC, and IEAVGMNS: IEABGM03 to 
continue GETMAIN processing. 


For entry point IEAVGMFC: IEAVGM03 to 
continue FREEMAIN processing. 


For entry point IEAVGMGE: IEAVGM03 and 
IEAVGM04 to process GETMAIN/FREEMAIN 
errors. 


Exit to: Caller. 


IEAVGM03 — GETMAIN/FREEMAIN Service 
Routine 


Operation: This module allocates (GETMAIN) and 
deallocates (FREEMAIN) virtual storage in the SWA 
and authorized user region of each address space. 


Entries: 


RMBRANCH — for register type, unconditional 
GETMAIN or FREEMAIN. 
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CRBRANCH — for register type GETMAIN or 
FREEMAIN branch entry (conditional or 
unconditional). 

Entry from: 


For entry point IGC010: IEAVESVC for register 
type, unconditional GETMAIN or FREEMAIN. 


For entry point IGC120: IEAVESVC for register 
type GETMAIN or FREEMAIN. 


Exit to: Caller. 


IEAVGM04 — GETMAIN/FREEMAIN Service 
Routine | 


Operation. This module allocates (GETMAIN) and 
deallocates (FREEMAIN) virtual storage in the user 
region of each address space. 
Entries: 
IEAVGM4G — for GETMAIN processing. 
IEAVGM4F — for FREEMAIN processing, 
Exit to: Caller. 


IEAVGPRR — GETPART/FREEPART Functional 
Recovery Routine 


Operation: This module attempts to cleanup and recover 
from the following error situations encountered in 
module IEAVPRT0; program checks, machine checks, 
ABENDs, percolation from a subordinate FRR, and 
operator restart. 
Entry from: 

For entry point EAVGPRR: IEAVTRTS. 


For entry point PRTOERTN: IEAVSY50 via 
IEAVEDSO. 


Exit to: TEAVEDSO. 
For entry point IEAVGPRR: IEAVTRTS. 


For entry point PRTOERTN: IEAVEDSO. 
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IEAVGTCL — GETCELL Routine 


Operation: This module allocates a cell from an existing 
quickcell pool. 


Entry from: A routine that requires quickcell allocation. 
Exit to: Caller. 
IEAVH600 — WQE Service Routine 


This module executes in the communication task 
address space and provides the following cross memory 
services to manipulate write-to-operator queue 
elements (WQEs) for users of the WIO/WTOR and 
DOM macros. 


e Locates a specific WQE in the communication task 
address space and copies it to the caller’s WQE 


e Copies the caller’s WQE(s) to the communication 
task address space 


e Sets the suspend indicator in the WQE for 
multi-line WTO processing 


e Chains a WQE to an operator request element 
(ORE) for WTOR processing 


Entry from: EAVMWTO, IEAVVWTO, IEAVXDOM 
via a PC. 


Exit to: Caller via PT. 
Called routines. TEAVQ700. 
Entry point. FRRCLNUP 


At this entry point EAVH600 performs cleanup for 
the communication task functional recovery routine 
(IEAVMFRR). If IEAVH600 had been processing a 
single-line WTO or WTOR when the error occurred, 
FRRCLNUP frees the WQE and adjusts the WOE 
counts in the UCM base. If EAAVH600 had been 
processing a multi-line WTO, FRRCLNUP turns off 
the suspend bit in the WOE and returns to | 
IEAVMERR with the number of WQEs processed. 


Entry from: RTM. 
Exit to: RTM. 


Called routines: None. 
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IEAVID00 — Identify Routine 
Operation: This module performs two functions: 
e It identifies an embedded entry to the system. 


e It identifies a single copy module loaded in subpool 
0 to the system. 


Entry from: 


For entry point IGC041: SVC interruption 
handler. 


For entry point FRRSVC41: RTM. 
Exit to: EXIT prolog. 
IEAVINV — Page Invalidation Routine 


Operation: The routine is divided into two parts known 
as the master and the slave subroutines. 

The master synchronizes all online processors, sets the 
invalid bit in the PGTE, purges the translation 
look-aside buffer (TLB) on the master processor, and 
signals the other processors to purge their TLBs. The 


slave portion purges the TLB on its processor when the 
master signals it to do so. 


Entry from: 
For entry point IEAVINV: An RSM routine. 
For entry point IEAVINVA: IEAVEES. 
Exit to: Caller. 
IEAVIOCP — Paging I/O Completion Processor 
Operation: This module performs the 
address-space-dependent processing required to 
indicate that a page-in operation has completed. It 
processes PCBs with I/O complete and PCBs for the 
address space in which IERAVIOCP is running. 
Entry point. TEAVIOCP from IEAVEDSO. 
Entry point: IEAVCPBR. 
Exit to: Caller. 
IEAVITAS — Initialize Address Space 


Operation: This module builds and initializes RSM 
control blocks required to define an address space. 


Entry from: TIEAVGCAS. 
Exit to. TEAVGCAS. 
IEAVLK00 — BLDL/FETCH Interfaces 


Operation: This module contains the description and 
code for several service routines: 


LINK SVC 6 at entry point IGC006 
XCTL SVC 7 at entry point IGC007 
LOAD SVC 8 at entry point IGC008 
DELETE SVC 9 at entry point IGCO09 
SYNCH SVC 12 at entry point IGC012 
LINK SVC 122 at entry point IGCOX6 | 
XCTL SVC 122 at entry point IGCOX7 
LOAD SVC 122 at entry point IGCOX8 


In addition to the above service routines, this module 
includes other code whose functions are described 
below. 

For entry point IGC006 and IGCOX6: 

e Performs a validity check of resources 


e Establishes linkage to the module 


e Searches for and determines the load module to 
which linkage is desired | 


e Creates and updates a program request block, an 
extended control block (XSB), and a contents 
directory entry under certain conditions 


e Performs a sharing of load modules in accordance 
with reusability attributes 


e Invokes the test module via an SVC call in 
TEAVLKO1 for TSO modules in test 


For entry point IGC007 and IGCOX7: 
e Performs linkage to the load module specified 


e Searches lists and libraries for the specified load 
module 


e Creates and updates a PRB, an XSB, and a CDE 
as for IGC006 


e Fetches the module 
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¢« Reclaims the current SVRB for type 4 SVC’s 
during the processing 


For entry point IGCO008 and IGCOX8: 


e Acquires a specified load module and retains the 
module for use by the task issuing the load 


e Searches as in IGCO06 


e Creates a twelve-byte load list element (LLE) that 
points to the CDE for the requested module 


e Increases the use count in the CDE and LLE when 
a module is loaded 


« Creates a 32-byte CDE when none exists for the 
requested module 


e Keeps a responsibility count in the LLE 

e Returns entry point even if module is in use; will 
not queue load requests for a serially reusable 
module 

e Causes modules to be fetched as for IGCO006 

For entry point IGC009: 

e Indicates that the usage of a module is complete 

e Locates the named module 

e Decreases the use count in the CDE and LLE and 
if the count in the CDE goes to zero, it forces the 
purging of the module 

For entry point IGCO12: 

e Allows the supervisor routine to give control to a 
problem program routine and to regain control in 


supervisor mode 


e Gives task recovery the ability to schedule a 
synchronous exit routine 


e Allows a routine which has received control via a 
SYNCH request to get control in a specified key 


e Restores the caller’s registers on return from a 
SYNCH request 


e Provides options which allow the caller to set the 


storage key and the program key mask for the exit 
that is to receive control 
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For entry point IEAQCSO1: This entry provides 
supervisor-assisted linkage for ATTACH requests. 


For entry point EAQCS02: This entry starts a queued 
request through mainline LINK. 


For entry point EAQCS03: This entry restarts a 
queued serially reusable request. 


For entry point EAVVMSR: This entry searches the 
pageable LPA directory for an LPDE representing the 
requested module. 


For entry point IEAQCDSR: This entry searches a 
CDE queue for a requested name. 


For entry point IEAQCS04: This entry address is the 
start of a list of addresses which IEAVLKO1 uses to 
return to IEAVLKOO0. There is no linkage because this 
is an external reference and not executable. 
For entry point CDLKBASE: This entry address resets 
the base address for IEAVLKOO on return from 
IEAVLKO1. There is no linkage as this is an external 
reference and not executable. 
Entry from: 
For entry points IGC006 and IGCOX6: SVC IH. 
For entry points IGC007 and IGCOX7: SVC IH. 
For entry points IGC008 and IGCOX8: SVC IH. 
For entry point IGCO009: SVC JH. 
For entry point IGC012: SVC IH. 


For entry point IEAQCS01: ATTACH 
(IEAVEATO) or memory create (IEAVEMCR). 


For entry point EAQCS02: POST (IEAVSY50). 
For entry point EAQCS03: POST (IEAVSYS50). 


For entry point EAVVMSR: Control program and 
user routines. 


For entry point IEAQCDSR: Control program and 
user routines. 
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Exit to: 


For entry points IGC006 and IGCOX6: Routine to 
be linked via a branch entry to EXIT prolog; wait 
if request was queued. 


For entry points IGC007 and IGCOX7: Routine to 
be linked via a branch entry to EXIT prolog; wait 
if the requested module was queued. 


For entry point IGC008 and IGCOX8: Caller via 
EXIT prolog (IEAVEEXP). 


For entry point IGCO009: Caller. 


For entry point IGC012: Caller using EXIT prolog. 


For entry point EAQCS02: Same as IGC006. 
For entry point IEAQSC03: Same as IGC006. 
For entry point IEAVVMSR: Return on register 
14+0, if an LPDE is found; return on register 
14+4 if no LPDE is found. 
For entry point IEAQCDSR: Return on register 
14+, if a CDE is found; return on register 14+4 
if no CDE is found. 

Error exit. RTM via an ABEND macro. 


IEAVLK01 — Program Management Search — Fetch 
Interface Module 


Operation: This module performs the following services 
for IEAVLKO0: 


e Controls the order of queue and library searches 


e Interfaces with the BLDL service routine using 
SVC 18 


e Interfaces with the program fetch service routine 
(IEEWMSEPT) using a branch 


e Provides an interface to test using SVC 61 

e Processes alias PDS entries so that the major name 
module can be reused, if possible, for an alias 
request 


Entry from: TEAVLKO0 via branch. 


Exit to: TEAVLKOO. 


IEAVLK02 — Program Management Resource 
Management Routines 


Operation: This module cleans up CDEs and any 
associated storage at EXIT, DELETE, ABEND and 
EOT. 


Entry from. ABEND. 
Exit to: Program management. 


Entry point CDHKEEP: This entry releases the module, 
extent list, major CDE, and associated minors as 
required. 


Entry from: DELETE service routine (IGC009). 

Exit to: Caller via BR 14. 

Entry point GXLHKEEP: This routine frees CSA 
storage associated with modules that have been loaded 
into the CSA. 

Entry from: RTM2 via a branch. 

Exit to: Caller via a branch. 

Entry point IEAPPGMxX: This routine frees the program 
management resources when an RB exits and 
determines if a task termination is in progress, and if 
so, frees any LLEs left on the TCBLLE queue, their 


associated CDEs and its associated storage. 


Entry from: EXIT (IEAVEOR) via branch with 
LOCAL lock held. 


Exit to: Caller (SVC 3) via branch. 


Entry point EAPPGMA: This routine removes partially 
loaded programs during ABEND processing. 


Entry from: TEAVTRT1 via branch. 

Exit to: Caller via BR 14. 

IEAVLK03 — Program Management Recovery Routine 
Operation: This module attempts to prevent unwanted 
abends in the program manager by intercepting them 
and correcting errors if possible. The routine verifies 


CDE and LLE queues for abend situations that are not 
due to user error. 
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Entry point CDEVER: This entry point receives as input 
an address and verifies that the address points to a 
CDE. 


Entry from: TEAVEQVO. 
Exit to: Caller. 


Entry point FRRPGMMG: This entry point provides 
program manager recovery for the basic program 
management functions. 


Entry from: RTM. 
Exit to: RTM. 


Entry point FRRPGMX: This entry point is the recovery 
routine for the exit resoruce manager (IEAPPGMX). It 
verifies the CDE and LLE queues and attempts a retry. 


Entry from: RTM. 
Exit to: RTM. 


IEAVMASV — Communication Task Asynchronous 
Service Routine 


Operation: The asynchronous service routine performs 
TPUT services for the communication task. The TPUT 
services issue the WAIT macro instruction. 


Entry from. IEAVTPUT and IEAVMASYV. 
Exit to: The dispatcher via a BR 14. 
IEAVMDOM — Communication Task DOM Processor 


Operation: The communication task DOM processing 
routine processes the DOM control blocks (DOMCs) 
created by the DOM macro instruction processing 
routine (IEAVXDOM). For each DOMC message ID, 
this routine attempts to eliminate the WQE that has the 
same message ID and the ORE associated with that 
WQE, if an ORE exists. If the WQE was retained in 
the action message retention buffer, it is removed. The 
device support processor is then called to eliminate 
graphic messages with the same message ID. 


Entry from: EAVMOWR. 


Exit to: The communication task’s wait service routine 
via a BR 14 instruction. 
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IEAVMDSV — Communication Task Device Service 
Routine 


Operation: The device service routine prepares the 
communication task for and issues SVC 72 (the device 
support processor (DSP)). The preparation includes 
handling pending open, close, I/O completion 
interrupt, and attention interrupt processing. This 
routine also cleans up the write queue elements 
(WQEs), operator reply elements (OREs), and console 
queue elements (CQEs) when these control blocks are 
no longer needed, and assures that all messages have 
been processed for master tracing. Additionally, it 
retains messages in the action message retention buffer. 


Entry from: TEAVMQWR and IEAVMDSV. 

Exit to: Caller via a BR 14 instruction. 

TEAVMED2 — WQE/ORE Purge Routine 

Operation: This module purges WTO elements and 
ORE (operator reply elements) at task or address space 


termination. In particular, it: 


e Frees any write wait blocks (WWBs) from the 
ORE and WQE chain. 


e Marks any OREs to indicate that deletion is in 
progress. a 


e If this is an address space deletion, creates a 
DOMCB for a DOM by address space identifier 
(ASID). 


« If deleting a job step, it creates a DOMCB for a 
DOM by ASID and jobstep TCB. 


e Marks any active graphic device UCME to indicate 
that there is DOM work to be done. 


e Stops monitor requests for this task or storage by 
calling the monitor control routine (IEAVMNTR). 


e Posts the UCMDECB. 


e Passes a task-related DOMCB to the subsystem 
interface. 


Entry from: Address space or task termination. 


Exit to: Caller. 
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TEAVMFIH — MSSFCALL SLIH Routine 
(IEAVMFTH) 


Operation. TEAVMFIH processes class 2401 MSSF 
external interrupts, which are generated by the MSSF 
hardware when it finishes processing an MSSFCALL 
DIAGNOSE instruction. 


Entry from: TEAVEEXT. 
Exit to: Caller. 
IEAVMFRM — MSSFCALL Resource Manager 


Operation: TEAVMFRM cleans up any MSSFCALL 
resources held by a terminating task or address space. 
These MSSFCALL resources include the MSFAB and 
MSFCEB control blocks and the MSSFCALL TP PORT 
serialization resource. 


Entry from: TEAVTMMT during address space 
termination or IEAVTSKT during task termination. 


Exit to: Caller. 


IEAVMFRR — Communication Task Functional 
Recovery Routine (FRR) or ESTAE Controller 


Operation: The FRR/ESTAE controller receives 
control from recovery termination management 
(RTM). The controller processes both FRR and 
ESTAE attempts to recover from abnormal 
terminations in the communication task. 


Entry from: RTM via FRR stack. 

Exit to: RTM via a BR 14 instruction. 

IEAVMNTR — Monitor Queue Manager 

Operation: This module maintains the monitoring status 
of operators’ consoles and TSO terminals. This is done 
primarily for the MONITOR and STOPMN command 


processors. 


Entry from: EAVMED2, IEAVSWCH, IEES503D, 
TEE7103D, IKJEFFO0, or IEE4603D. 


Exit to: Caller. 
IEAVMODE — Mode Change Routine 
Operation: This module changes the key and state in the 


SVC old PSW (SVCOPSW), changes the system mask, 
or changes the PSW key mask (control register 3). It 


changes the state of the system by altering the RB old 
PSW. 


Entry from: SVC TH. 
Exit to: EXIT prolog. 


IEAVMQRO — Communication Task Process Message 
for Inactive Terminal (Console) 


Operation: This routine gives the master console 
operator an opportunity to delete, queue to the master 
console, or continue queueing messages that are sent to 
a specific console by identification. 


Entry from: TEAVMWSV. 
Exit to: The dispatcher via a BR 14 instruction. 


IEAVMQWR — Communication Task Wait Service 
Routine 


Operation: The wait service routine waits on all of the 
event control blocks (ECBs) that are posted for the 
communication task. 


Entry from: TEAVN701. 
Exit to: No exit; this is a never-ending routine. 


IEAVMSF — Monitoring and System Support Facility 
(MSSFCALL) SVC Routine 


Operation: TEAVMSF provides the interface between 
MVS software and the hardware’s monitoring and 
system support facility (MSSF). It determines whether 
the requested MSSFCALL command can be processed, 
and, if so, issues an MSSFCALL DIAGNOSE 
instruction on behalf of the requestor. 

Entry from: SVC FLIH (IEAVESVC). 

Exit to: Address in register 14. 

Called routines: Validity check routine (IEAVEVAL). 
JEAVMSFS — MSSFCALL SRB Routine 

Operation: After the MSSF hardware finishes executing 


an MSSFCALL DIAGNOSE instruction that 
TEAVMSF issued while processing an MSSFCALL 
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SVC, it generates a class 2401 MSSF external | 
interrupt. IEAVMFIH receives control to schedule 
IEAVMSFS, which posts the ECB that IEAVMSF is 
waiting on. 


Scheduled by: TEAVMFTH. 


IEAVMWSV — Communication Task Console Queueing 
Routine | 


Operation: The console queueing routine selectively 
queues messages to console output queues and passes 
eligible messages for master tracing. 


Entry from: TEAVMDSV, IEAVMQWR. 
Exit to: The device service routine (IEAVMDSV), 
which returns control to the communication task’s wait 


service routine (IEAVMOWR). 


IEAVMWTO — Communication Task Multiple-Line 
WTO Service Routine 


Operation: The communication task multiple-line WTO 
(MLWTO) service routine prepares major and minor 
write queue elements (WQEs) associated with multiple 
line messages. 

Entry from: TEAVVWTO. 

Exit to: TEAVVWTO. 

Called routines. TEAVH600, IEAVM700, IEFJSREQ. 
IEAVM700 — MPF Scan Routine 

Operation: This module scans the MPF table built by 
IEECB805. The table contains message IDs and | 
prefixes of messages to be suppressed. EAVM700 
determines whether the message ID or prefix passed as 
input matches any of the entries in the MPF table. 
Entry from: IATCNMR, IEAVVWTO, IEAVMWTO. 
Exit to: IATCNMR, IEAVVWTO, IEAVMWTO. 
IEAVOUT — Page Out 

Operation. This module processes all page-out requests 
initiated by the PGOUT macro instruction. If the page 


needs to be written to auxiliary storage, this module 
starts the I/O request. 
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Entry from: TEAVPSI. 

Exit.to: TEAVPSI. 

IEAVPCB — PCB Manager 

Operation: This module moves PCBs to various queues 
as requested and ensures that an adequate supply of 
PCBs is in the free queue pool for requesters. It also 
maintains the SRB pool. 

Entry from: An RSM module or IEAVNIP0. 

Exit to: Caller. 

IEAVPFTE — PFTE Enqueue/Dequeue Routine 
Operation: This module moves PFTEs to and from 
PFTE queues as directed or needed. It also restarts 
deferred general frame allocation (GFA) requests and 
monitors the level of the AFQ (available frame queue). 
Entry from: RSM modules. 

Exit to: Caller. 

IEAVPIOI — Swap I/O Initiator 

Operation: This module invokes the ASM interface 
routine to initiate paging I/O for swap-out of an 
address space. 

Entry from: TEAVEDSO. 

Exit to. TEAVEDSO. 

IEAVPIOP — Page I/O Post 

Operation: This module performs functions relating to 


paging I/O, including frame validation and freeing of 
PCBs and frames. 


Entry from: 


For entry point IEAVPIOP: ILRIOCOO, 
ILRMONOO, or ILRQIOOO. 


For entry point EAVOPBR: IEAVIOCP, 
IEAVTERM, IEAVRELS, IEAVAMSI, 
IEAVGFA, or IEAVSOUT. 


Exit to: Caller. 
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IEAVPIX — Program Check Interrupt Extension 
Operation: This module functions as an interface 
routine between the program check interruption 
handler (PCIH) and the general frame allocation 
(GFA) routines. 

Entry from: EAVEPC. 

Exit to: TEAVEPC. 

IEAVPREF — Frame Allocation Steal Function 
Operation. This module steals a frame from a local 
frame queue, the common frame queue, or the real 
storage buffer queue to be used for SQA, LSQA, or for 
a fixed page. 

Entry from: TEAVGFA or IEAVSQA. 

Exit to: Caller. 

IEAVPRT0O — GETPART/FREEPART Routine 


Operation: This module allocates or frees a virtual 
region. 


Entry from: TEAVGMO0. 

Exit to. TEAVGMO0 or IEAVEQR. 

Error exit: TEAVTRT2. 

IEAVPSI — Page Services Interface (PSI) Module 
Operation: This module receives all page service 
requests. The requests serviced are PGFIX, PGFREE, 
PGLOAD, PGRLSE and PGOUT. This module checks 
input parameters for errors and routes control between 


the page services modules necessary to satisfy the input 
request. 


Entry from: 


For entry points IGC112 and IGC113: 
IEAVESVC. 


For entry points IEAVPSIB, IEAVPSIF, 
IEAVPSIX, IEAVPSIY, IEAVPSIZ, and 
IEAVPSXM: A supervisor state key 0 routine. 


For entry points IEAVPSII and NEXTVSL: An 
RSM routine. 


Exit to: 
For entry points IGC112 and IGC113: IEAVEOR. 
For all other entry points: Caller. 
Error exit: 
For entry points IGC112 and IGC113: IEAVRCV. 
For entry points IEAVPSIF, IEAVPSIX, 
IEAVPSIY, IEAVPSIZ, and IEAVPSXM: 
IEAVDSPC. | 
TEAVQ700 — Communications Task Queue Scanner. 
Operation: This module scans a particular 
communications task resource queue to search for an 
entry containing those characteristics specified by the 
caller. The address is returned to the caller, when the 
entry is found. The address field is set to zero when no 


entry is found. 


Entry from. TEAVH600, IEAVMDOM, IEECB804, 
TEE8103D. 


Exit to: Caller. 
IEAVRCF — Real Storage Reconfiguration Routine 
Operation. This module attempts hardware recovery 
(storage data and key errors), fields requests for 
varying storage offline and online, and provides current 
frame status. 
Entry from: 

For entry point IEAVRCF: IEEMPVST. 


For entry point IEAVRCFC: IEAVRCF via 
IEAVEDSO. 


For entry point IEAVRCFI: IEAVPFTE. 
Exit to: Caller. 
TIEAVRCF3 — Real Storage Reconfiguration Module 
Operation: This module adds to or subtracts from the 
real storage frames currently available for use by the 


system. This module also records the status of the real 
frames. 
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Entry from: 


For entry points EAVRCF3 and IEAVPBAD: 
IEEVSTGL. 


For entry point IEAVRF3I: IEAVPFTE. 

For entry point IEAVRF3C: Dispatcher. 
Exit to: Caller. 
Called routines. TEAVPFTE and IEAVPCB. 
IEAVRCV — Real Storage Management Recovery 
Operation: This module attempts to recovery from 
program checks, machine checks, operator restarts, 


percolation from subordinate FRRs, and expected and 
unexpected ABEND requests in RSM routines. 


Entry from: 
For entry point IEAVRCV: IEAVTRTS. 


For entry point IEAVRCV2: IEAVTRTS to handle 
errors is IEAVRCV. 


Exit to: Caller. 
IEAVRELS -—- Page Release (PGRLSE) 
Operation: This module frees real and auxiliary storage 
associated with a virtual page. In the process, it 
quiesces any outstanding paging I/O for the page. 
Entry from: 

For entry point IEAVRELS: IEAVPSI. 

For entry point EAVRELV: IEAVGMO0. 
Exit to: Caller. 


Entry point. TEAVRELF from IEAVIOCP, 
IEAVFREE, or IEAVTERM. 


Exit to: Caller. 

IEAVRFR — Real Frame Replacement and UIC Update 
Operation: This module is invoked by SRM when the 
steal algorithm is to be executed. It is passed a criteria 


number by which it is to decide which frames are 
eligible to be stolen. 
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This routine is used to remove pages from a given 
address space and return the frames to the available 


pool. 

The unreferenced interval count (UIC) update routines 
(IEAVRERP for private and IEAVRFRC for common) 
are invoked by SRM to update the usage history and 
the unreferenced interval count for each PFTE on a 
given frame queue. 

Entry point: TEAVRFR from IRARMSRV. 

Exit to: TRARMSRV. 

Entry from: At IEAVRFRP from IRARMSRV. 

Exit to: TRARMSRV. 

Entry from. At IEAVRFRC from IRARMSRV. 

Exit to: TIRARMSRV. 

EEAVRTIO — Timer Second Level Interrupt Handler 
Operation. This module processes interrupts caused by 
a synchronization check, by the processor timer, or by 
the clock comparator. This module also contains the 
TQE enqueue and dequeue routines. 

Entry point. TEAVEEXT at IEAOTIOO. 

Exit to: TEAVEEXT. 

Entry point. TEAVRT00, IEAVRTIO, IRARMSRV, 
IEAVRTOD, IEE6503D, IEAVRT02, IGX00013 at 
TEAQTEO00. 

Exit to: Caller. 


Entry point. TEAVRT00, IEAVRTIO, IRARMSRV, 
IEAVRT11, IEE6503D at IEAQTDOO. 


Exit to: Caller. 

Entry point: TEAVRTI0, IEAVRTOD at IEAVRCKQ. 
Exit to: Caller. 

Entry point. TEAVRQCK from IEAVEXS. 

Exit to: TEAVEXS. 

Entry point: TEAVRSAE from IEAVEDSO. 


Exit to. TEAVEDSO. 
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IEAVRTI1 — Timer Purge and Recovery 

Operation: This module performs four functions: the 
TQE purge function called by a terminating task or 
memory; the hardware recovery routine called by 
RTM; initialization timer control block fields and timer 
hardware when a new processor is varied online; and 
the FRR for timer supervision which includes a TQE 
validation routine. 


Entry point: TEAQPGTM from IEAVTSKT or 
IEAVTMMT. 


Entry point. TEAVRSPG from IEAVEDSO. 
Entry point. TEAVRCLS from IEAVTRTH. 
Entry point. TEAVRCLX from IEAVEDSO. 
Entry point. TEAVRNEW from IEEVCPU. 
Entry point: TEAVRSPN from IEAVEDSO. 
Entry point: TEAVRFRR from IEAVTRTS. 


Entry point. TEAVRTVR from IEAVRFRR or 
IEAVEQVO. 


Exit to: Caller. 

IEAVRTOD — TOD Clock Manager 

Operation: This module initializes TOD clocks at IPL 
and when a processor is varied online and resets or 
resynchronizes TOD clocks suffering machine checks. 
Entry point. TEAVRINT from IEEVIPL. 


Entry point. TEAVRSSC from IEAVRTOD and 
IEEVCPU. 


Entry point: TEAVRCLA from IEAVEDSO. 
Entry point. TEAVRNOT from IEEVCPU. 
Entry point. TEAVRCAN from IEEVCPU. 
Exit to: Caller. 


IEAVRT00 — TTIMER Service Routine (SVC 46) and 
STIMER Service Routine (SVC 47) 


Operation: TTIMER will supply the time remaining in a 
task’s time interval which was previously established 
via the STIMER routine. TTIMER will also, if 


requested, cancel the interval. STIMER establishes a | 
time interval for the requesting task. 


Entry point: IGCO004F from IEAVESVC. 

Entry point. iGC0004G from IEAVESVC. 

Exit to. TEAVEOR. 

Error exit: TEAVTRT2. 

IEAVRT01 — TIME Service Routine (SVC 11) 
Operation: This module supplies the user with local time 
and date, or optionally, with Greenwich Mean Time 
and date. The current value of the Time-of-Day clock 
can also be requested. 

Entry point: IGC0001A from IEAVESVC. 

Exit to: TEAVEOR. 

Entry point. TEAVRTME from IEAVEES. 

Exit to. TEAVEES. 

Entry point. TIMESTAE from IEAVTAS1. 

Error exit: TEAVTRT2. 

IEAVRT02 — SETDIE Routine 

Operation: This module allows a system program to 
establish a real-time interval. After the interval has 
passed, the program’s disabled interrupt exit (DIE) 
routine gets control. 

Entry point: TEAVRDIE from system caller. 

Exit to: System caller. 

IEAVRT03 — SRB Time Limit Initialization 


Operation: This module establishes a specified time limit 
for a program executing in SRB mode. 


Entry from: Issuer of a SRBTIMER macro. 
Exit to: Caller. 
Error exit. Return to caller that is not in SRB mode. 


Called routines: Dispatcher job step timing collection 
subroutine (entry point DSJSTCSR in IEAVEDSO). 
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IEAVSETS — STATUS Service Routine 


Operation: The module manipulates TCB indicators to 
change the dispatchability of tasks, SRBs, or the 
system. | 


For entry point IGCO79: Manipulates 
dispatchability of tasks, SRBs, or the system. 


For entry point IGC07902: Manipulates the 
dispatchability of tasks and SRBs. 


For entry point IGC07903: Starts SRB in 
swapped-in address spaces. 


For entry point IGC07904: Resumes the processing 
which had been suspended pending the release of a 
CML lock. 


For entry point IEAVSSNQ: Stops non-quiescable 
SRBs in address spaces being swapped-out. 


For entry point TEAVESSS: Completes stop 
SYNCH processing. 


For entry point IEATRSCN: Searches the subtask 
tree structure. 


For entry point EAVSET1: Clears all other 
processors of active tasks dispatched in the 
currently dispatched address space. 

Entry from: 
For entry point IGC079: SVC IH. 


For entry point IGC07902: Supervisor routines via 
branch entry. 


For entry point IGC07903: Swap-in. 
For entry point 1GC07904: The lock manager. 
For entry point EAVSSNQ Swap-out. 


For entry point IEAVESSS: EXIT and EXIT 
prolog. 


For entry point IEATRSCN: Branch entry from 
system routines. 


For entry point IEAVSET1: The attention exit 
scheduling routine or other system routines. 
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Exit to: 
For entry point IGC079: Exit prolog. 
For entry point IGC07902: Caller or dispatcher. 
For entry point IGC07903: Caller or dispatcher. 
For entry point IGC07904: Caller or dispatcher. 
For entry point IEAVSSNQ: Caller or dispatcher. 
For entry point IEAVESSS: Caller or dispatcher. 


For entry point IEATRSCN: Branch to caller via 
BR 11 if no task found, or BR 14 if task is found. 


For entry point IEAVSET1: Caller. 
IEAVSOUT —— Swap Out 


Operation: This routine proposes to process or move an 
address space from the system at the direction of the 
system resource manager (SRM). This includes 
purging all paging I/O for the address space, purging 
fixes for the address space, freeing LSQA frames, 
indicating which pages should be swapped in, and 
building the control blocks which will control the 
swap-out of pages which need to be written to auxiliary 
storage. 


Entry point. TEAVSOUT from IEAVARO2. 
Exit to: EAVARO2. 
TEAVSQA — LSQA or SQA Allocation 


Operation: This module allocates real storage frames for 
use as SQA or LSQA pages. 


Entry point. TEAVSQA from IEAVGMO0 or 
TEAVITAS. 


Exit to: Caller. 
IEAVSTAA: Communication Task ESTAE Routine 


Operation: This ESTAE routine is the last attempt to 
recover from an abnormal termination in the 
communication task. Previous attempts to recover may 
have been made by the functional recovery routine 
(FRR) and ESTAE processing (IEAVMFRR). 
IEAVSTAA reinitializes all fields that are necessary to 
make the system believe the communication task has 
not failed. 
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Entry from: RT™. 


Exit to: The dispatcher to end the communications task 
for later reinitialization. 


Error exit: A branch return to the recovery termination 
management routine (RTM) based on the address in 
register 14. 


IEAVSTA0 — (E)STAE Service Routine (SVC 60) 


Operation: This module creates, overlays, cancels, or 
propagates STAE control block(s). 


Entry from: SVC 60 call or a branch entry by another 
SVC routine. 


Exit to: Caller via exit if SVC entered, or directly to 
caller if branch entered. 


Exit-error. ABEND caller. 


IEAVSWCH — Communication Task Console Switch 
Routine 


Operation: The console switch routine analyzes and 
switches console functions. 


Entry from: IEAVMWSV, IEECVETW, IEAVVCTR, 
IEAV1052, IEECVETC, IRAV1443, IEAV2540, 
IEE8B03D. 


Exit to: A branch return to the address in register 14. 
IEAVSWIN — Swap In Processor 

Operation: This module performs the processing 
required to initiate a swap-in of an address space from 
the auxiliary paging space. The secondary 

entry performs processing to connect the address space 
to the set of active address spaces when the required 
I/O is complete. 

Entry point. IEAVSWIN from IEAVEDSO. 

Exit to. TEAVEDSO. 


Entry point: TEAVSIRT from IEAVPIOP, IEAVGFA, 
IEAVIOCP or IEAVTERM. 


Exit to: Caller. 


IEAVSWPC — Swap-out Completion Processor . 
Operation: This routine frees the frames and PCBs for 
swap-out and removes the address spaces from the 
dispatching queue. 

Entry from: ILRPAGCM. 

Exit to: Caller. 

IEAVSWPP — Swap-In Completion Processor 
Operation. Scheduled by Swap-In Root Exit 
(IEAVSIRT entry point in IEAVSWIN). This module 
starts input page operations for stage 2 pageable 
working set pages and posts the region control task 
(RCT) to restart task-mode processing in a swapped-in 
address space. 

Entry from: TEAVEDSO. 

Exit to: EAVEDSO. 

IEAVSY50 — Wait/Post Service Routine . 

Operation: This module performs two services: 

» WAIT | 


— Which causes the caller to stop processing and 
wait for the occurrence of one or more events. 


e POST 
— Which signals completion of an event in an 
ECB and determines if the waiting task has | 


become ready. 


— It also identifies and deletes user POST exit 
routines and routes control to them. 


For entry IEAOPT02: Performs the POST service. 


For entry IEAOPT0O3: Performs the POST service 
for programs executing as a POST exit routine. 


For entry IEAOPTOE: Performs the POST exit 
identification and deletion service. 


For entry EARPOST: POST resource manager. 


Entry from: 
For entry IGCO01: SVC IH. 
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For entry IEAVWAIT: Supervisor routine via 
branch entry. 


For entry IGC002: SVC IH. 


For entry IEAOPTO1: Supervisor routine via branch 
entry. 


For entry IEAOPT02: Supervisor routine via branch 
entry. 


For entry IEARPOST: RTM. 


For entry IEAOPTO3: Supervisor routine via branch 
entry. 


For entry IEAOPTOE: Supervisor routine via 
branch entry. 


Exit to: 


For entry IGC001: Exit prolog (IEAVEXP1), or 
ABEND. 


For entry IEAVWAIT: Dispatcher (IEAODS). 

For entry IGC002: Exit prolog or ABEND. 

For entry IEAOPTO1: Caller. 

For entry IEAOPTO2: Caller. 

For entry EARPOST: Caller. 

For entry IEAOPT03: Caller. 

For entry IEAOPTOE: Caller. 
IEAVTABD — ABDUMP 
Operation: This module manages the SYSABEND, 
SYSUDUMP, and SYSMDUMP data sets. It provides 
tlie interface to SNAP and SVC dump for dump 
requests to one of these data sets during 
recovery/termination processing. 
Entry from: IEAVTRTC via BALR. 
Exit to: TEAVTRTC. 
IEAVTABI — ABDUMP Initialization 
Operation: This module reads PARMLIB IEAABD00, 
IEADMP00, and IEADMR0O0 and sets the requested 


dump options in the recovery termination control table 
(RTCT) for later use by ABDUMP (IEAVTABD). 
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Entry from. TEAVNPAG6 via BALR. 
Exit to: TEAVNPAG6. 
IEAVTACR — Alternate processor Recovery 


Operation: This module uses a ’good’ (recovery) 
processor to take over the work in progress on a ’dead’ 
(malfunctioning) processor at the time of its failure, 
and to supervise the cleanup of that work until the 
system can resume normal operation: 


Entry from: 
e RMS EMS/MFA SLIH on the recovery processor. 


e Lock manager and certain global spinners when 
conflict is detected between recovery and dead 
processor work. 


e Dispatcher when recovery or dead processor work 
is interrupted. 


Exit to: 

e Caller via register 2. 

e Interrupted work of other processor. If this is first 
time for dead processor work exit to RTM for FRR 


recovery. 


e If work of each processor is in enabled condition 
exit to dispatcher. 


IEAVTADR — Address Conversion Routine 
Operation: This module converts a coded string 
representing a direct or indirect address into a 


four-byte virtual address. 


Entry from: TEAVTSLP via BALR, AHLTSLIP via 
BALR, IEECB905 via BALR. 


Exit to: Caller. 

IEAVTAS1 — Task Recovery Pre-exit Processing 
Operation: This module sets up workareas for ESTA 
exit, gives the exit control and calls IEAVTAS2 and 
IEAVTASS3 for post-exit processing. The pre-exit 


functions of this module are as follows: 


e Identify the SCB (ESTAE/STAE exit). 
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e Obtain and initialize SDWA. 


e Perform the user I/O options requested on ESTAE 
macro. 


e Set up interface for the user exit routine. 


e Issue SYNCH macro to pass control to the user exit 
routine. 


Entry from: TEAVTRTC via BALR. 
Exit to: TEAVTRTC. 
IEAVTAS2 — Task Recovery Post Exit Processing 


Operation: This module performs the requests made by 
the user exit routine. Its functions are the following: 


Perform a validity check on the SDWA. 
Track SDWA by issuing HOOK macro. 
Perform recording if requested. 

Copy dump options from SDWA. 

Suppress STAI percolation, if requested. 
Determine whether to retry or continue with 
termination. 


Entry from: TEAVTAS1 via BALR. 
Exit to: EAVTAS1. 


IEAVTAS3 — Setup for User Retry or Continue with 
Termination 


Operation: This module performs processing for user 
retry or percolation. Processing consists of the 
following: 


Retry: 


« Identify the RB for retry. 

¢ Initialize or freemain SDWA for retry. 

e Close embedded DCBs. 

e Purge paging I/O. 

e Purge outstanding WTOR requests for STAE retry 

only. 

Purge entries in type 1 message table. 

Purge enqueued resources if ESTAR. 

Purge TQEs if ESTAR. 

Set pointer to EXIT (RB) or exit prolog (SVRB) in 

resource PSW. 

e Perform SCB clean-up. 

e« Handle pseudo retry into IEAVTAS1 if there is 
recursion. 


Percolation: (continue with termination) 

e FreeSDWA 

Entry from: TEAVTASI1 via BALR. 

Exit to: TEAVTAS1. 

IEAVTB00 — SPIE/EXTRACT Service Routine 

Operation: The module provides two services: 

e SPIE, which provides the problem program with a 
means of specifying an error exit routine in | 
response to one or more program error 
interruptions. 

« EXTRACT, which provides a means of obtaining 
the address of the values of a set of fields without 


going through the system. 


For entry IGC0001D: Performs SPIE mainline 
processing. 


For entry IEAVSPIE: SPIE resource manager. 
For entry IEAVSPI: Checkpoint/restart entry. 


For entry IGC00040: Performs EXTRACT 
mainline processing. 


For entry IGC00040+8: Performs EXTRACT 
mainline processing. 


Entry from: 
For entry IGC0001D: SVC IH. 
For entry IEAVSPIE: RTM. 
For entry IEAVSPI: Checkpoint/restart. 


For entry IGC00040+8: Supervisor routines via 
branch entry. 


Exit to: 
For entry IGCOO01D: Exit prolog. 
For entry IEAVSPIE: Caller. 


For entry IEAVSPI: Caller. 
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For entry IGC00040: Exit prolog. 

For entry IGC00040+8: Caller. 
IEAVTERM — Paging Termination Services 
Operation. This module quiesces paging I/O for a 
particular RB or TCB. For a task being terminated, 
RTM may also request that all pages fixed for a task be 
freed. 
Entry point: TEAVTERM from IEAVTSKT. 
Exit to: TEAVTSKT. 
IEAVTEST — TESTAUTH Service Routine 


Operation: This routine tests the authorization of any 
program to perform a specified function. 


Entry from: 
For entry IGC119: SVC IH. 


For entry IEAVTEST: Supervisor routine via 
branch entry. 


Exit to: 
For entry IGC119: EXIT prolog. 
For entry IEAVTEST: Caller. 
IEAVTFHX — HEX Format Subroutine 
Operation: This subroutine formats a single summary 
dump record in standard hexadecimal dump format 
with characters on the side. 
Entry from: TEAVTFSD. 
Exit to: Caller. 


IEAVTFMT — MAINLINE for RTM Control Block 
Formatter 


Operation: Locates the RTM control blocks associated 
with the TCB passed in the parameter list. It then calls 
the individual formatters for each RTM control block. 
Entry from: TEAVADO1 or AMDPRUIM. 


Exit to: Caller. 
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IEAVTFRD — Summary Dump Read Subroutine 


Operation: This subroutine reconstructs the records of a 
summary dump from a dump data set being processed 
by AMDPRDMP. 


Entry from: IEAVTFSD. 
Exit to: Caller. 


IEAVTFRT — Interface between IEAVTFSD and 
Several RTM Control Block Format Subroutines 


Operation: Using summary dump data to simulate a 
total dump environment this module invokes the RTM | 
control block format subroutines IEAFTIHS, 
IEAFTFRR, IEAFTRT2. 


Entry from: TEAVTFSD. 
Exit to: Caller. 


IEAVIFSD — AMDPRDMP Service Aid Exit for 
SUMDUMP Control Statement 


Operation: This module controls the formatting of an 
entire summary dump by calling format subroutines to 
process each summary dump record. 


Entry from: AMDPRDMP via the user exit interface | 
(entry point AMDUSRXT in AMDPRUIM). 


Exit to: Caller. 


IEAVTFTM -— Message and Subroutine Name CSECT 
for EAVTFSD 


Operation: This message CSECT contains all the text 
for the dump output headers and comments generated 
by IEAVTFSD, IEAVTFRD, and IEAVTFHX. It also 
contains a branch table of subroutines to load and call 
for each type of summary dump record. : 


Used by. TEAVTFSD. 


IEAVTGLB — SLIP Global PER 
Activation/Deactivation Routine 


Operation: This mcdule manages the global resources 
on all processors necessary to activate, deactivate, or 
adjust PER monitoring. This module is scheduled by 
IEFECB905, IEAVTIBN, IEAVTLCL, and 
IEAVTSLP. 


Entry from: SRB dispatcher. 
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Exit to. SRB dispatcher. 

IEAVT JBN — SLIP PER Selection Interface Routine 
Operation: This module serves as an interface between 
address space create and IEAVTLCL to determine if a 
new address space should have PER monitoring active. 
It also serves as the interface between scheduler 
routines (started task control and SWA create control) 
and SLIP PERa routines to determine if a LOGON, 
START, or job select requires a change to PER 
monitoring in an address space. 


Entry from: TEAVEMRQ via BALR, IEESB605 via 
BALR, IEFIB600 via BALR. 


Exit to: Caller. 


IEAVTLCL — SLIP Local PER 
Activation/Deactivation Routine 


Operation: This module determines if PER monitoring 
should be on or off for the address space in which it is 
running and adjusts the RB and ASCB indicators 
accordingly. IEAVTGLB also schedules this routine to 
adjust the RB and ASCB indicators as required. This 
routine is scheduled by IEAVTGLB and IEAVTIBN. 
Entry from: SRB dispatcher. 

Exit to: SRB dispatcher. 

Called routines: TEATRSCN, IEAVESSE, IEAVSETS. 
IEAVITMMT — Memory Termination Purges 


Operation: This module handles the purging of 
resources held by a terminating address space. 


Entry from: IEAVTRTE via BALR. 
Exit to: Caller. 
IEAVTMRM —~ RTM Memory Resource Manager 


Operation: This module frees all SDWAs obtained from 
SQA by RTM1. 


Entry from. TEAVTMMT via BALR. 


Exit to: Caller. 


IEAVTMSI — Recovery Termination’s Master 
Scheduler Initialization Controller 


Operation: This module creates the following three 
recovery termination tasks in the master address space: 


¢ Recording task 
e Address space termination control task 
e SVC dump task 


Entry from: Master scheduler (TIEEMB860) via a LINK 
macro to begin recovery/termination initialization. 


Exit to: Master scheduler (IEEMB860) via a RETURN 
statement with return code 0 or 4. 


TIEAVTMTC — Memory Termination Controller 


Operation: This module controls the process of 
responding to a request for address space termination. 


Entry from: TEAVTMSI via ATTACH. 


Exit to: None. This is a never-ending task that waits on 
an ECB when there is no work to do. 


IEAVTMTR — Memory Termination Requestor 
Operation: This module is attached by the memory 
termination controller to invoke memory termination 
purges via SVC 13. 

Entry from: TEAVTMTC via ATTACH. 

Exit to: Caller. 


IEAVTPER — Program FLIH/SLIP PER/Space 
Switch Interface Module 


Operation: This module provides the interface used to 
call the SLIP processor (IEAVTSLP) to handle a PER 
interrupt or the space switch handler (IEAVTSSH) to 
handle a space switch interrupt detected by the 
program check FLIH (IEAVEPC). 

Entry from: TEAVEPC via BALR. 

Exit to: Caller. 

IEAVTPMT — Type 1 Message Table Handler 


Operation: This module prints or purges entries in the 
type 1 message table for the requested task. 
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Entry from: 


IEAVTRTC via BALR for printing and purging. 
IEAVTAS3 via BALR for purge. 
IEAVTSKT via BALR for purging. 


Exit to: Caller. 
IEAVTRCE — Trace Routine 


Operation: This module provides a trace function for 
the following events: 


External interruptions 

I/O interruptions 

Program interruptions 

SVC interruptions 

Start I/O (from IOS) 

Task dispatcher exit conditions 
Event dispatcher exit conditions 


For entry point TREX (the trace entry for external 
interrupts): External interrupt handler. 


For entry point TRIO (the trace entry for I/O 
interrupts): Supervisor. 


For entry point TRPI (the trace entry for program 
interrupts): Program interrupt handler. 


For entry point TRSVC (the trace entry for SVC 
interrupts): SVC interrupt handler. 


For entry point TRDISP (the trace entry for task 
dispatch): Dispatcher. 


For entry point TRSRB1 (the trace entry for event 
dispatch): Dispatcher. 


For entry point TRSRB2 (the trace entry for event 
redispatch): Dispatcher. 


For entry point TRSIO (the trace entry for START 
I/O): START I/O. 


For entry point IEAVTRCO (to turn system tracing 
on or off): GTF or SDUMP. 


For entry point TRCEFRR (trace recovery 
routine): RTM. 


Exit to: Caller by branching to the address in register 
11. 
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IEAVTRER — Recording Request Routine 


Operation: This module accepts requests for recording 
on SYS1.LOGREC or for writing to the operator, and 
it schedules the recording/ writing to occur 
asynchronously under the recording task. Also, if this 
is an emergency request from the machine check — 
handler, the termination routine’s emergency recorder 
returns the address and the length of the scheduled but 
not yet written logrec request for recording. 


Entry from: System routines via RECORD macro 
instruction. 


Exit to: Caller. 
IEAVTRET — Asynchronous Recording Task 
Operation: This module writes recording requests. 


Entry from: IEVTMSI via ATTACH, subsequently 
IEVTRER schedules an SRB to POST RTCTRECB. 


Exit to: None. This is a never-ending task that waits on 
an ECB when there is ‘no work to be done. 


IEAVTRMC — CALLRTM TYPE=RMGRCML 


Operation: At address space termination time, this 
module prepares for cleanup every SRB or task in the 
terminating address space that holds the local lock of 
another address space. 


Entry from: TEAVLKRM via CALLRTM. 

Exit to: TEAVLKRM. 

IEAVTRML — Installation Resource Manager List _ 
Operation: This CSECT can be replaced with a CSECT 
containing a list of modules to be called by task and 
address space termination. It is defined to look like a 
list with no entries. 

Entry from: Not executable. 

Exits: None. 

IEAVTRSO — RTM1 Service Routines 

Operation: This module contains several entry points 
used by EAVTRTM. Two of these entries 
(IEAVTRS2 and IEAVTRS4) are also called internally 


by IEAVTRS3. See the specific entry point for a 
description of its function. 
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Entry point IEAVTRS1: This entry point verifies that an 
ASID received by RTM1 as input represents a valid 
address space. 


Entry from: TEAVTRTM via BALR. 

Exit to. TEAVTRTM via BALR. 

Entry point IEAVTRS2: At this entry point, the module 
updates an EED with the dump options passed by the 
invoker of the ABEND, CALLRTM, or SETRP 
macros. 

Entry from: IEAVTRTM or IEAVTRS3 using BALR. 
Exit to: TEAVTRTM or IEAVTRS3 using BALR. 
Entry point IEAVTRS3: At this entry point, the module 
updates EEDs with error information and chains them 
on a queue. 

Entry from: IEAVTRTM via BALR. 

Exit to: TEAVTRTM via BALR. 

Entry point IEAVTRS4: This entry point puts the 
ERRORID (sequence number, logical processor 
identification, and time stamp) and the 
FRR-to-ESTAE communication buffer into the EED. 
Entry from: TEAVTRTM or IEAVTRS3 via BALR. 
Exit to: TEAVTRTM or IEAVTRS3 using BALR. 
Entry point IEAVTRSS: IEAVTRIM invokes this 
maintenance entry point when a user attempts to 
terminate an address space that cannot be terminated. 
This module uses the software recording facility to 
record the SDWA along with its variable recording 
area. 

Entry from: TEAVTRTM using BALR. 

Exit to: TEAVTRTM using BALR. 

Called routines: TEAVTRER. 

Entry point IEAVTRS6: IEAVTRTM uses this entry 
point to interface with the status routine to make a task 
dispatchable. 

Entry from: TEAVTRTM using BALR. 


Exit to: TEAVTRTM using BALR. 


Entry point IEAVTRS7: At this entry point, the module 
interfaces with IGPTERM to terminate the system by 
issuing the IEA802W message, which indicates that the 
system is in an AQO wait state. 


Entry from: IEAVTRTM via BALR. 
Exit to. |IGFPTERM via BALR. 
IEAVTRTC — RTM2 Mainline Controller 


Operation: This module controls the processing among 
subfunctions, including task recovery, dumping, and 
subtask handling. 


Entry from: [EAVTRT2 via BALR. 
Exit to: TEAVTRT2. 


IEAVTRTE — Control Task Purges, Memory Purges 
and Exit 


Operation: This module invokes modules to perform 
task and address space purges and causes the 
appropriate exit from RTM2. 


Entry from: IEAVTRT2 or IEAVTSKT via BALR. 


Exit to. PROLOG or to STATUS to set the task 
temporarily or permanently nondispatchable. 


IEAVTRTH — RTM Hardware Error Processor 


Operation: This module interfaces with hardware repair 
routines and records a MCH LOGREC buffer to 
SYS1.LOGREC for all CALLRTM TYPE=MACHCK 
entries. The module also accumulates data describing 
the error and its repair status for inclusion in the 
recovery routine interface. 


Entry from: TEAVTRTM via BALR. 
Exit to: Caller. 


IEAVTRTM — Recovery Termination Manager Number 
1 


Operation: This module performs the following 
functions: 


¢ Interfacing with the module IEAVTRTH for 


recording and repairing damage after a hardware 
failure 
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« Interfacing with the system recovery manager 
module IEAVTRTS for routing control to the 
recovery routines that protect a supervisor path 
and for recording software incidents 


e Percolating errors to tasks or address spaces that 
are affected by the error 


e Interfacing with the module IEAVTRTR which 
handles recovery for RTM1 


¢« Handling the ABTERM, MEMTERM, and 
STERM services 


Entry from: TEAVTRT1 via BALR. 


Exit to: TEAVTRTI1 via BALR, unless system 
termination is necessary, then exit to IEAVTRSO. 


Called routines: TEAVTRSO, IEAVTSLP. 
IEAVTRTR — RTM Recovery Routines 


Operation: This module contains the recovery routines 
for the RTM1 routines and also routines to perform 
SLIP processing. 


Entry point: 


For entry FREEDCEL: This entry interfaces with 
the QUICKCELL routine to free any quickcells 
that are no longer needed. 


For entry RTMRSFRR: This entry provides 
recovery for IEAVTRTM if a recursive error 
occurred during an attempt by RTM to perform its 
reschedule function. 


For entry RTHFRR: This entry provides recovery 
for IEAVTRTH. 


For entry RTMSMFRR: This entry continues the 
recovery initiated by RTMRSFRR. 


For entry RCOVGETM: This entry defines an 
FRR that provides recovery for IEAVTRTS when 
a GETMAIN for an SDWA fails while processing 
an error in unlocked SRB mode or for an enabled 
unlocked task with FRRs. 


For entry RCOVRCRD: This entry defines a FRR 
that provides recovery of IEAVTRTS in the event 
that recording an SDWA on behalf of an FRR 
fails. 
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For entry RCOVRGTF: This entry defines a FRR 
that provides recovery of IEAVTRTS in the event 
that GTF (invoked by IEAVTRTS to trace FRR 
recovery) should fail. 


For entry RECVRRTM: This entry provides 
recovery for RTM1 during that part of its 
processing in which FRR protection is not possible 
or practical. 


For entry IEAVTRTL: This entry is used by SLIP 
entry and by RTM when a SLIP function is to be 
performed. This entry schedules an SVC DUMP or 
places the system in a wait state via module 
TEESTPRS. 


For entry SLIP2FRR: This is the recovery code for 
the IEAVTRTL ENTRY function. It frees any 
acquired resources obtained by IEAVTRTL 


For entry RCOVRDMP: This entry defines an 
FRR that provides recovery for IEAVTRTS when 
dump options are being copied into the SDWA. 


For entry RCOVRCMS: This entry defines an 
FRR that provides recovery for [EAVTRTS if the 
CMSET instruction used to enter the FRR’s 
addressing environment fails. 


For entry FREESRBS: This entry frees the SRB 
and EEDs obtained during XMABTERM 
processing in IEAVTRTM. This routine is a task 
and address space termination resource manager. 
It receives control when in XMABTERM 
processing an SRB is scheduled but before getting 
dispatched has its related task or address space 
terminated. 


Entry from: 


For entry points FREEDCEL and IEAVTRTR: 
IEAVTRTS using LPSW or BALR. 


For entry point RECVRRTM: 
IEAVTRTM using BALR. 


For entry point FREESRBS: PURGEDQ using 
BALR. 


Exit to: 


For entry FREEDCEL: Caller. 
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For entry RCOVRCRD: IEAVTRTS; or indirectly 
to EAVTRTR’s entry point RECVRRTM to 
terminate RTM1’s processing of the error. 


For entry RCOVRGTF: IEAVTRTS; or indirectly 
to IEAVTRTR’s entry point RECVRRTM to 
terminate RTM1’s processing of the error. 


For entry RECVRRTM: IEAVTRTM or 
IEAVTRTS when RTM1’s processing can 
continue; or to dispatcher IEAVODS or SRB 
dispatcher when RTM1’s processing of an error is 
terminated. 


For entry IEAVTRTS: Indirectly to IEAVTRTR at 
entry point RECVRRTM to terminate RTM1’s 
processing of the error. 
For entry FREESRBS: PURGEDQ. 
For all remaining entry points: EAVTRTS. 
IEAVTRTS — System Recovery Manager 
Operation: This module provides the interface and 
control between the control program and the functional 


recovery routines defined to recover the control 
program. 


e Interfaces with the software recording facility 
(IEAVTRER) to record the software errors 


e Interfaces with GTF to provide tracing of FRR 
recovery 


¢ Interfaces with SLIP (IEAVTSLP) to activate any 
additional serviceability for the error being handled 
by RTM1 

Entry from: EAVTRTM via BALR. 

Exit to: TEAVTRTM. 

Called routines: TEAVTRTR. 

IEAVTRT1 — RTMI Entry Point Processor 

Operation: This module serves as an extension to the 

CALLRTM macro instruction and creates a common 

interface for the mainline RTM1. 

Entry point. PROGCK from caller via BALR. At this 

entry, the module gathers data pertinent to a program 

interruption for mainline RTM 1. 


Exit to: TEAVTRIM via BALR. 


Entry point: RESTART from caller via BALR. At this 
entry, the module gathers data pertinent to a restart 
interruption for mainline RTM1. | 


Exit to: TEAVTRTM via BALR. 


Entry point: SVCERR from caller via BALR. At this 
entry, the module gathers data pertinent to a program 
issuing an SVC in a locked, disabled, EUT (enabled, 
unlocked task that has established an FRR), or SRB | 
environment. 


Exit to. TEAVTRTM via BALR. 


Entry point: SVCERR from caller via BALR. At this 
entry, the module saves the caller’s registers and 
establishes a recovery environment. 


Exit to: TEAVTRTM via BALR. 


Entry point. STERM from caller via BALR. At this 
entry, the module saves the caller’s return address and 
establishes a recovery environment. 


Exit to. TEAVTRTM via BALR. 


Entry point. DATERR from caller via BALR. At this 
entry, the module checks to determine whether the 
DAT error occurred in the home address space or in 
another address space. If the error occurred in the 
home address space, the module gathers data pertinent 
to a translation failure and passes control to mainline 
RTM1. Otherwise, it obtains, initializes, and schedules 
an SRB to run in the master’s address space. (See 
entry point DATMEM in IEAVTRT1.) 


Exit to: EAVTRTM using BALR if the DAT error 
occurred in the home address space; PROGCK using 
BALR if the DAT error occurred in another address 
space. 


Entry point. XABTERM from caller via BALR. At this 
entry, the module saves the caller’s registers in a 
caller-provided save area and establishes a recovery 
environment. 


Exit to. TEAVTRTM via BALR. 
Entry point. CABTERM from caller via BALR. At this 
entry, the module saves the caller’s registers in an RTM 


WSA and establishes a recovery environment. 


Exit to: TEAVTRTM via BALR. 
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Entry point. MEMTERM from caller via BALR. At 

this entry, the module saves the caller’s registers in a 
caller-provided save area and establishes a recovery 

environment. 


Exit to. EAVTRTM via BALR. 


Entry point: TEAVTRTN via LPSW. This entry is the 
machine check reentry, at which the module sets up an 
interface for software recovery from a hardware error. 


Exit to: TEAVTRTM via BALR. 

Entry point: TEAVTRTX from SRB dispatcher via 
LPSW. This entry is the cross address space ABTERM 
reentry, at which the module sets up an interface for 
the ABTERM function of RTM1. 

Exit to: TEAVTRTM via BALR. 

Entry point: TEAVTRTZ from IEAVTRTM on return 
(BR 14). At this entry, the module sets up the final 
exit linkage back to the mainline supervisor as directed 
by RTM1. 

Exit to: 


For retry: Branch via register 15 which is loaded 
with the retry address returned by RTM1. 


For MCH: BR 14. 


For restart resume: LPSW of old PSW stored by 
the restart interrupt handler. 


Dispatcher: Branch to the address in CVTODS. 
For SRB: Branch to the address in CVTSRBRT. 
For SVC: Branch to the address in CVTEXPRO. 
Caller: BR 14. 


For EXIT prolog: Branch to the address in 
CVTEXPRO. 


Entry point. DATMEM from the SRB dispatcher via 
LPSW. This section of code is an SRB scheduled by 
this module at the DATERR entry point when a DAT 
error occurs in an address space other than the home 
address space. This entry point terminates the address 
space in which the DAT error occurred. 


Exit to: SRB dispatcher by means of BR 14. 
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Called routines. TEAVELKR. 


Entry point. DATMEFRR from IEAVTRTS via LPSW. 
This entry point is the FRR for the DATMEM entry 
point in IEAVTRT1. DATMEFRR frees the resources 
(an extended error descriptor block (EED) cell, the 
DISP lock, and the global intersect) obtained by 
DATMEM. 


Exit to: TEAVTRTS by means of BR 14. 


IEAVTRT2 — RTM2 Initialization (SVC 13 Entry 
Point) 


Operation: This module obtains and initializes the work 
area, and controls routing among major parts of RTM2 
(including mainline, exit processing, and critical error 
handling). It also interfaces with SLIP (IEAVTSLP) to 
activate any additional error processing for the error 
being handled by RTM2. 


Entry from: SVC FLIH. 

Exit to: TEAVTRTE via BALR. 

Error exit: Branch to dispatcher via STATUS. 
IEAVTRV — Translate Real to Virtual 


Operation: This module is given a real address as input. 
If the real storage page is assigned to a page of virtual 
space, IEAVTRYV returns the corresponding virtual 
address and ASID. 


Entry from. At IEAVTRV from any routine, for 24 bit 
real address passed as input. At IEAVTRV3 from any 
routine for 26 bit real address passed as input. 


Exit to: Caller. 
IEAVTSBP — Task Recovery Resource Manager 


Operation: This module transfers the ownership of 
eligible SCBs to the new RB during XCTL processing. 
It purges SCBs from the queue when an RB issues an 
exit or entry to EAVTSBP for cleanup after an 
ATTACH failure. 


Entry from: 


IEAVEATO (because of an ATTACH failure) by 
means of a BALR to the entry point address of 
IEAVTSBP contained in CVTSCBP. 
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TEAVEDR (for EXIT processing) by means of a 
BALR to the entry point of IEAVTSBP contained 
in CVTSCBP. 


IEAVLKOO (for XCTL processing) by means of a 
BALR to the entry point address of IEAVTSBP 
contained in CVTSCBP. 


IEAVTRTM (for RTM processing) by means of a 
BALR to the entry point address ESTAECHK 
contained in a V(con). 


Exit to: Caller - with return code 0 or 4. 
IEAVTSCB — SCB FREEMAIN Routine 


Operation: This module limits the number of cells on 
the free SCB queue and frees all excess cells. 


Entry from: TEAVTSKT via BALR. 

Exit to: TEAVTSKT. 

Called routines: TEAVGMO0. 

IEAVTSDC — SVC Dump Clean Up Routine 


Operation: This module cleans up SVC dump resources 
after an SVC DUMP has completed. It frees any locks 
held and writes an end-of-file mark on the dump data 
set. IEAVTSDC makes the tasks of the address space 
being dumped dispatchable, it also makes the system 
dispatchable (if it is not already from a previous SVC 
DUMP process). IEAVTSDC issues two messages, 
IEA911E (signaling dump completion to the operator) 
and IEA984E (signaling end-of-volume on the tape 
dump). IEACVPST branches to a secondary. entry 
point, IEAVTSDA, turns off the RTCTDSST (data set 
full) bit in the RTCT for the new SYS1.DUMP data set 
tape. 


Entry from: TEAVAP00 (synchronous SVC DUMP via 
BALR), IEAVTSDT (scheduled SVC DUMP via 
BALR). | 


Secondary entry point. TEAVTSDA. 

Exit to: Caller. 

IEAVTSDF — SVC Dump GTF Trace Processor 
Operation: If the trace table is a requested part of the 
SVC DUMP and GTF is active, this module invokes 


GTF to obtain the saved GTF trace records. It calls 
IEAVTSDP to write these records on the dump. 


Entry from: TEAVADO00 via BALR (synchronous SVC 
DUMP), IEAVTSDT via BALR (scheduled SVC 
DUMP). 


Exit to: Caller. 
IEAVTSDG — SVC Dump Global Storage Processor 


Operation: This module adds address ranges to the SVC 
dump address range table for the following storage 
areas: nucleus (NUC), PSA, SQA, CSA, and TRT (if 
supervisor trace is active). It calls IEAVTSDO0 to write 
the storage areas described by the address ranges in the 
address range table on the dump data set. 


Entry from: TEAVADO0 via BALR — synchronous 
SVC dump. IEAVTSDT via BALR — scheduled SVC 
dump. 


Exit to: Caller. 
Modules called: TEAVTSDO — output processor. 
IEAVTSDH — SVC Dump Data Set Initialization 


Operation. This module chooses the dump data set for 
SVC dump. The SDUMP 4K buffer and the 
AMDPRDMP header record are written on the dump 
data set. This module uses console interface 
instructions to obtain the console loop trace buffer. If 
the console loop trace data has not been previously 
read, the trace buffer is written on the dump data set. 
The SVC dump address range table is initialized. 
Message IEA994A is issued to the operator if all 
SYS1.DUMP data sets are full and the requested dump 
cannot be taken. Tape dump data sets are considered 
full when no tape is mounted. 


Entry from: IEAVAD00 via BALR — synchronous 
SVC DUMP. IEAVTSDT via BALR -— scheduled SVC 
DUMP. 


Exit to: Caller. 


Modules called: TEAVTSDP (entry point in 
IEAVTSDO). 


IEAVTSDI — SVC Dump Initialization Routine 


Operation: This module acquires storage for the 
SDUMP work area, the SDUMP buffer and the 
summary dump work area. The SDUMP work area, the 
summary dump module (IEAVTSSD), and modules 
IEAVTSDT, IEAVTSDH, IEAVTSDO, and 
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IEAVTSDW are page fixed in real storage. The dump 
data set table in the RTM control table (RTCT) is 
initialized with information about the SYS1.DUMP 
data sets. This module places the entry point of 
module IEAVTSDR in the CVT; the entry point of 
module IEAVTSSD in the summary dump work area 
(SMWK); and the address of the attention routine, 
IEAVTSDA, in attention table index 32, maintained by 
IOS. ? 


Entry from: TEAVNPAG via BALR. 
Exit to: Caller. 
IEAVTSDL — SVC Dump Local Storage Processor 


Operation: This module adds address ranges to the SVC 
dump address range table for the following storage 
areas: LSQA, SWA, RGN (including LSQA and 
SWA), and LPA. Module IEAVTSDO is called to write 
the storage areas described by the address ranges in the 
address range table on the dump data set. 


Entry from: IEAVADO00 via BALR — synchronous 
SVC dump. IEAVTSDT via BALR — scheduled SVC 
dump. | 


Exit to: Caller. 

Modules called: TEAVTSDO — output processor. 
IEAVTSDO — SVC Dump Output Processor 
Operation: This module performs I/O to write on the 
dump data set the storage areas described in the SVC 
dump address range table. Secondary entry point 
IEAVTSDP is used to write one record on the dump 
data set. Secondary entry point IEAVTSEO allows 
SVC dump exits to write data on the dump data set. 
Entry from: EAVTSDG via BALR — write out global 


storage. IEAVTSDL via BALR — write out local 
storage. 


Secondary entry points: TEAVTSDP and IEAVTSEO. 
Exit to: Caller. 

IEAVTSDR — SVC DUMP Resources Manager 
Operation: This module will clean up SVC dump 
resources if an address space fails in which SVC dump 
is active. | 


Entry from: TEAVTMMT via BALR. 
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Exit to: TEAVTMMT. 


IEAVTSDT — SVC Dump Task (one in every address 
space) attached at address space creation time 


Operation: This module performs SVC dump processing 
in each address space that is the target of a scheduled 
SVC dump request. It is awakened in an address space 
when the SRB routine, scheduled by IEAVTSDX, 
executes the POST function. It calls the SVC dump 
service modules IEAVTSDH, IEAVTSDG, 
IEAVTSDL, IEAVTSDF and IEAVTSDC to dump the 
requested storage of the address space in which this 
routine is awakened. 


Entry from: Attached by IEAVTSDX (via POST) 
during address space creation, at DUMPREQ for each 
dump request of the address space in which this module 
is resident. DUMPREQ is a label in IEAVTSDT where 
processing starts when the task is resumed. 


Exit to: None. This is a never ending task (as long as 
the address space exists). 


IEAVTSDU — SVC Dump Exit Interface Routine 


Operation: This module allows component dump exit 
routines to be invoked by SVC dump in order to add 
component-related data to the dump. A general 
parameter list is passed to the exit routine. The exit 
routines to be called are defined in CSECT 
IEAVTSXT in SYS1.LINKLIB. The exit definitions 
give the name and attributes of each exit routine. 


Entry from: TEAVAD00 and IEAVTSDT via BALR. 
Exits called: TEEMB879, ISGDSMP. 

Exit to: Caller. 

IEAVTSDW — SVC Dump Summary Dump Writer 


Operation: This module puts the data in the summary 
dump buffers into AMPRDMP format and invokes 
module IEAVTSDP to write these constructed records 
on the dump data set. In cases where the real storage 
buffer frame address is greater than 16 Mb or the real 
address of the SVC dump output buffer is greater than 
16 Mb, IEAVTSDN calls IEAVWNDE to obtain 
virtual addressability to both frames. As the contents 
of each frame is written on the dump data set, this 
module returns the frame to RSM. 


Entry from: IEAVTSDT via BALR. 
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Called routines: TEAVTSDP, IEAVWNDE, 
IEAVTSVO. 


Exit to: Caller. 
IEAVTSDX — SVC Dump Branch Entry Module 


Operation. This module schedules an SVC dump in the 
address space(s) specified by the caller. It schedules an 
SRB in the requested address space(s). The SRB 
routine posts the dump task (IEAVTSDT) in the 
address space(s) requested. 


Entry from: Caller via BALR. 
Exit to: Caller. 


Called routines: TEAVSETS, IEAVSY50, IEAVTSSD, 
IEAVTSSV, IRARMINT. 


IEAVTSFR — SETFRR 


Operation. The SETFRR macro calls this module to 
update the FRR stacks. Depending on the request, 
IEAVTSFR adds or deletes a current stack entry, 
purges all the entries from the current stack, flushes all 
the entries from the normal stack, or flushes all the 
entries from the normal stack and then adds an entry to 
this stack. 


Entry from: SETFRR macro. 

Exit to: Caller. 

IEAVTSIG — SLIP PER RISGNL Routine 

Operation: This module adjusts the PSW PER indicators 
in the I/O, external, and SVC new PSWs, and loads 
the PER control registers (9-11) with appropriate 
values when PER monitoring is being activated or 
deactivated. 

Entry from: TEAVTGLB via BALR. 

Exit to: Caller. 

IEAVTSIN — FRR Stack Initialization 

Operation: IEAVTSIN is an executable macro included 
by IEAVNIPO and IEEVCPU to perform FRR stack 
initialization for a given processor. 

Entry from: This inline expansion is included by 


IEAVNIP0 (during system initialization) and by 
IEEVCPO (during vary processor processing). 


Exit to: Caller. 
IEAVTSKT — Task Termination 


Operation: This module handles the releasing of a 
terminating task resource. 


Entry from: TEAVTRTE via BALR. 
Exit to. TEAVTRTE. 
IEAVTSLB — SLIP Action Processor — Part 2 


Operation. This module routes control to the SLIP trap 
match routines (IEAVTSL1 or IEAVTSL2) 
depending on the parameters found in the SCVA)) and 
processes the MATCHLIM and PRCNTLIM 
keywords. 


Entry from: TEAVTSLP. 

Exit to. TEAVTSLE. 

Called routines. TEAVTSL1, IEAVTSL2. 
IEAVTSLE — SLIP Action Processor — Part 3 


Operation: This module initiates message processing 
requested by IEAVTSLP when a trap has been 
automatically disabled. IEAVTSLE also removes the 
recovery environment established by IEAVTSLP, and 
returns to the caller of IEAVTSLP. 


Entry from: TEAVTSLB, IEAVTSLR. 
Exit to: The caller of EAVTSLP. 
YEAVTSLP — SLIP Action Processor — Part 1 


Operation: This module receives control when SLIP is 
active from either an RTM routine as part of normal 
processing, or from IEAVTPER after a PER 
interruption. IEAVTSLP establishes error recovery to 
match the environment of the caller, serializes the SCE 
chain, and passes control to IEAVTSLB to continue 
SLIP action processing. 


Entry from. IEAVTRTS, IEAVTRT2, IEAVTRTM, or 
IEAVTPER. 


Exit to: TEAVTSLB. 
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JIEAVTSLR ~~ SLIP Processor Recovery 


Operation: This module provides the FRR recovery for 
the SLIP processor modules (IEAVTSLP, IEAVTSLB, 
IEAVTSLE, IEAVTSL1, IEAVTSL2, IEAVTSLS) and 
the address conversion routine (IEAVTADR) when it 
is called by SLIP. If a recoverable error has occurred, 
this module attempts a retry at an appropriate point in 
the SLIP processor module. If the error is not 
recoverable, IEAVTSLR requests percolation. 


Entry from: TEAVTRTS (FRR router). 
Exit to: TEAVTRTS. 
IEAVTSLS — SLIP Processor Service Routine 


Operation: This module is called to: determine the 
system mode, issue a DUMP, or schedule IEAVTGLB 
to turn off PER monitoring. 


Entry from: IEAVTSLB, IEAVTSL1, IEAVTSL2. 
Exit to: Caller. 
IEAVTSL1 — SLIP Trap Matching Routine — Part 1 


Operation: This module determines whether the event 
qualifier keywords specified on the SLIP command 
match the current system conditions. IEAVTSLI1 
processes the ADDRESS, ASID, COMP, ERRTYP, 
JOBNAME, JSPGM, LPAMOD, MODE, RANGE, 
and ASIDSA event qualifier keywords. 


Exit to: Caller. 

IEAVTSL2 — SLIP Trap Matching Routine — Part 2 
Operation: This module: determines whether the event 
qualifier keywords specified on the SLIP command 
match the current system conditions (IEAVTSL2 
processes the DATA and PVTMOD event qualifier 
keywords). When a match is found for all event 
qualifier keywords, EAVTSL2 is called to perform the 
action specified in this trap. 

Entry from: TIEAVTSLB. 

Exit to: Caller. 

IEAVTSR1 — ITERM Processor 

Operation: This module processes CALLRTM macros 


that specify TYPE=ITERM and COMPCOD=cc. 
RTM uses IEAVTSR1 to abnormally terminate an 
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interrupted SRB or TCB. IEAVTSR1 prepares this 
interrupted SRB or TCB for the abend. 


Entry from: Issuer of CALLRTM using BALR. 
Exit to: Caller. 


Entry point SRIRETRY: This entry point prepares 
IEAVTSR1 for an abend by placing the SVC 13 
address in the old PSW. It also deletes the recovery 
environment. 


Entry from: SR1IFRR. 
Exit to: Caller. 


Entry point SRIFRR: This entry point is the FRR for 
IEAVTSR1. It puts diagnostic information into the 
SDWA. If the error occurred in the GETCELL routine, 
it retries. Otherwise, it frees the EED and requests 
recording and percolation. 


Entry from: IEAVTRTS via LPSW. 
Exit to: TEAVTRTS by means of BALR. 


IEAVTSSD — SVC DUMP Disabled Summary Dump 
Processor 


Operation: For branch entries to SVC dump, this 
module invokes RSM (IEAVPRSB) and obtains a real 
storage buffer from the the real storage backing the 
pageable link pack area. It calls IEAVTSSM to move 
volatile system information into these real storage 
frames. Module IEAVTSDW later writes the saved 
information on the dump data set in AMDPRDMP 
format. 


Entry from: TEAVTSDX via BALR. 
Exit to: Caller. 


IEAVTSSE — SVC Dump Enabled Summary Dump 
Processor 


Operation: For nonbranch entries to SVC DUMP, this 
module writes a summary dump on the dump data set. 
This summary dump includes the following storage 
areas: 


e Storage areas specified with the SUMLIST keyword 
on the SDUMP macro 


e Supervisor trace table 


Licensed Material — Property of IBM 


e RTM2WA (if one exists) 


e 2K of storage plus and minus unique addresses 
found in the registers at the time of error. 


Entry from: IEAVTSDT via BALR, IEAVAD00 via 
BALR. 


Exit to: Caller. 
IEAVTSSH — SLIP Space Switch Handler 


Operation: When a unit of work changes the address 
space in which it is executing, this module adjusts the 
PER bit in the PSW according to the criteria 
established on the SLIP command. 


Entry from: 


For entry point EAVTSSH: IEAVTPER when a 
space switch interrupt occurs. 


For entry point IEAVTSS1: Any issuer of the 
CMSET SET macro when there is an active SLIP 
trap for that macro. 


For entry point IEAVTSS2: Any issuer of the 
CMSET RESET, CHKAUTH=YES macro when 
there is an active SLIP trap for that macro. 


For entry point IEAVTSS3: Any issuer of the 
CMSET RESET, CHKAUTH=NO macro when 
there is an active SLIP trap for that macro. 


Exit to: 


For entry point IEAVTSSH: IEAVTPER using a 
BR 14. 


For entry points EAVTSS1, IEAVTSS2, 
IEAVTSS3: Caller using a BR 14. 


IEAVTSSM ~~ SVC Dump Summary Dump Data Move 
Routine 


Operation: For disabled and suspend summary dumps, 
this module moves volatile system data to the real 
storage buffer or the virtual storage buffer located in 
the DUMPSRV address space. In cases where the real 
storage buffer frame address is greater than 16 Mb or 
the real address of the SVC dump output buffer is 
greater than 16 Mb, IEAVTSSM< calls EAVWNDE to 
obtain virtual address ability to both frames. 


Entry from: IEAVTSSD using BALR. IEAVTSSV 
using BALR. 


Called routines. TEAVWNDE. 
Exit to: Caller. 


IEAVTSSV — SVC Dump Suspend Summary Dump 
Processor 


Operation: For branch entries to a SVC dump with the 
SUSPEND=YES keyword specified, this module calls 
IEAVTSSM to move volatile system information to the 
virtual storage buffer located in the DUMPSRV 
address space. 


Entry from: IEAVTSPX (SCHSRB) using BALR. 

Exit to: Caller. 

IEAVTSSX — Space Switch Extension 

Operation: This module adjusts the PER bit in the PSW 
for RTM1. IEAVTSSX performs the same function as 
IEAVTSSH, but is tailored to meet the needs of 
RTM1. 

Entry from: TEAVTRTS (RTM1) using a BALR. 

Exit to: EAVTRTS using a BR 14. 


IEAVVCRA ~~ Communication Task Console Attention 
Processor 


Operation: The console attention processor receives 
control as a result of someone pressing the console’s 
attention key. Pressing the attention key causes an 
attention interrupt. As a result of the attention 
interruption, this routine posts the communication task. 


Entry from: IEACVPST. 


Exit to: The POST status routine of the IOS handler via 
a BR 14 instruction. 


IEAVVCRX — External Interrupt Key Processor 
Operation: This module receives control from the 
external first level interrupt handler to post the 
communication task. 


Entry from: TEAVEEXT. 


Exit to: The external first level interrupt handler by 
branching to the address in register 2. 
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JIEAVVCTR — SVC 72 Router 


Operation: TEAVVCTR determines the appropriate 
device support processor (DSP) to process the 
communications task service. 


Entry from: Issuer of SVC 72. 
Exit to: 


¢ JIEAV1052 for a 1052 printer-keyboard, 3210 
console printer-keyboard, 3215 console 
printer-keyboard, or 3213 console printer 
supported as a console. 


« JTEAV1443 for a 1443 printer, 1403 printer, or 
3211 printer supported as a console. 


e JEAV2540 for a 2540 card reader punch, 2501 
card reader, 2520 card reader punch, 3505 card 
reader, or 3525 card punch supported as a console. 


» IBEC2740 for a 2740 communications terminal 
supported as a console. 


e IEECVETW for a 3284/3286 printer supported as 
a console. 


e JTEECVET1 for a graphics device supported as a 
console. 


IEAVVRP2 — Reply Processor - Stage 2 


Operation: This module checks whether the text of a 
user’s buffer area is valid. If the buffer is valid, 
TEAVVRP2 moves the reply text into the buffer. 


Entry from: TEECB811 (via an SRB). 
Exit to: Dispatcher. 


IEAVVWTO — Communication Task Single-Line WTO 
and WTOR Service Routine (SVC 35) 


Operation: The WTO and WTOR service routine 
processes the SVC 35-issued by the WTO and WTOR 
macro expansion. It also receives control for the 
multiple-line WTO (MLWTO) and 
write-to-programmer (WTP) macros. For these two, 
TEAVVWTO branches to the MLWTO (IEAVMWTO) 
and WTP (IGC0203E) routines, respectively. When a 
WTO or WTOR message is sent to a console, 
IEAVVWTO posts the communication task. 


Entry from: TEAVESVC. 
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Exit to: The SVC first level interrupt handler by 
branching to the address in register 14. 


Error exit: When a WTO message has a length of zero 
bytes, the service routine branches to the SVC first 
level interrupt handler at the address in register 14. For 
all other errors, IEAVVWTO gives control to RTM via 
an ABEND macro. RTM terminates the issuer of the 
WTO or WTOR macro with completion code X’D23’. 


Called routines: TEAVH600, IEAVMWTO, 
IEAVM700, IEECVCTE, IGC0203E (CSECT in 
TEEJB840), IEFJSREQ. 


IEAVWND — RSM Window Service Routine 


Operation: This module provides a means of making 
one or two frames above the 16 megabyte (Mb) line 
temporarily virtually addressable. 


Entry from: 


For entry point IEAVWNDI: IEAVGFAX. This 
entry point does not set an FRR. The FRR Is 
already in place because it was set by the calling 
RSM routines. 


For entry point EAVWNDE: IECVDERP, 
IEAVTSSD, IEAVTSSM, IEAVTSDW, and 
IEEVALST. This entry point always sets an FRR. 


Exit to: Caller. 
Error exit: 


For entry point IEAVWNDE: For input parameter 
errors, this module issues an ABEND macro. For 
other errors, IEAVWND passes control to 
TEAVRCV. IEAVRCYV retries to entry point 
WNDRETRY (within EAVWND). WNDRETRY 
cleans up and returns to the caller of EAVWND 
with a return code of 8. 


For entry point EAVWNDI: IEAVRCYV receives 
control to record information about the error and 
then percolates. 


IEAVXDOM — Communication Task DOM Service 
Routine (SVC 87) 


Operation: The DOM service routine processes the SVC 
87 that is issued by the DOM macro expansion. This 
routine builds a DOM control block (DOMC) with the 
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message IDs of the messages to be deleted, then posts 
the communication task. 


Entry from: TEAVESVC. 


Exit to: The SVC first level interrupt handler by 
branching to the address in register 14. 


Error exit: RTM via an ABEND macro. RTM 
terminates the user of the DOM macro with completion 
code X’157’. 


Called routines. TEAVH600. 


IEAVXECO — PC/AUTH Service Routine that 
Connects an Entry Table 


Operation: This module connects entry tables to 
specified indexes in the linkage table of the home 
address space. 


Entry from: 


For entry point TEAVXECO: Issuer of an ETCON 
macro. 


For entry point IEAVXC05: PC/AUTH service 
routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 
Error exit. RTM via an ABEND macro. 


Called routines. TEAVXSET at entry point 
TEAVXACK, and IEAVEBBR. 


IEAVXECR — PC/AUTH Service Routine that Creates 
an Entry Table 


Operation: This module builds an entry table and its 
associated entry table information block (ETIB) for the 
home address space using an entry table description list 
provided by the caller. 


Entry from: 


For entry point IEAVXECR: Issuer of an ETCRE 
macro. 


For entry point IEAVXC03: PC/AUTH service 
routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 


Error exit: RTM via an ABEND macro. 


Called routines: TEAVQCDSR (CDE search routine), 
IEAVVMSR (LPDE search routine), and IEAVXEPM 
(nucleus entry point search routine). 


IEAVXEDE — PC/AUTH Service Routine that Deletes 
an Entry Table 


Operation: This module deletes a specified entry table 


and its associated entry table information block 
(ETIB). If the caller requests the purge option, 
IEAVXEDE also disconnects the entry table from all 
linkage tables. 


Entry from: Issuer of an ETDES macro. 
Exit to: Caller by issuing a PT instruction. 
Error exit. RTM via an ABEND macro. 


IEAVXEDI — PC/AUTH Service Routine that 
Disconnects an Entry Table 


Operation: This module disconnects an entry table(s) 
from the linkage table of the caller’s home address 
space. 


Entry from: Issuer of an ETDIS macro. 
Exit to: Caller by issuing a PT instruction. 
Error exit: RTM via an ABEND macro. 


IEAVXEPM — Program Call Nucleus Entry Point 
Search Module 


Operation. When called at entry point IEAVXEPM, this 
module searches the nucleus entry point table 
(IEAVXNET) for a specified entry point, and returns 
the entry point address to the caller. IEAVXEPM also 
receives control at entry point IEAVXABE when a 
program call (PC) instruction references a default entry 
table entry. It issues an X’0D6’ abend. 


Entry from: 
For entry point EAVXEPM: IEAVXMAS during 
PC/AUTH address space initialization (see System 
Initialization Logic), and TEAVXECR when 
creating an entry table. 


For entry point IEAVXABE: Branched to from a 
PC instruction. 
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Exit to: 


For entry point IEAVXEPM: Caller. 


For entry point IEAVXABE: RTM via an ABEND — 


macro. 
Error exit. RTM via an ABEND macro. 


IEAVXLFR — PC/AUTH Service Routine that Frees 
Linkage Indexes 


Operation: This module frees the linkage indexes 
specified by the caller. 


Entry from: 


For entry point IEAVXLFR: Issuer of an LXFRE 
macro. 


For entry point EAVXC02: PC/AUTH service 
routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 
Error exit: RTM via an ABEND macro. 
Called routines: TEAVXEDI via an ETDIS macro. 


IEAVXLRE — PC/AUTH Service Routine that 
Reserves a Linkage Index 


Operation. This module reserves linkage indexes for the 
caller’s home address space. 


Entry from: 


For entry point IEAVXLRE: Issuer of the LXRES 
macro. 


For entry point EAVXC01: PC/AUTH service 
routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 
Error exit: RTM via an ABEND macro. 


IEAVXMAS — See OS/VS2 System Initialization Logic 
for a module description of IEAVXMAS. 


IEAVXMIN — Memory Initialization Routine for 
PC/AUTH Services | 


Operation: During address space initialization, 


IEAVEMIN gives IEAVXMIN control in SRB mode. 
IEAVXMIN connects the address space being 
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initialized to the system authorization table (SAT) and 
system linkage table (SLT). It also sets the address 
space’s authorization index (AX) to zero and indicates 
that the address space can be accessed in cross memory 
mode. 


Entry from: 


For entry point IEAVXMIN: IEAVEMIN. 
For entry point XMINFRR: RTM. 


Exit to: Caller. 
IEAVXNEP — Nucleus Entry Point Table Module 


Operation: This module contains a table IEAVXNET) 
that includes: 


e The names of routines in the nucleus that can be 
entered using a program call (PC) instruction 


e A VCON for each routine’s entry point address 


Reference from: TEAVXMAS (described in System 
Initialization Logic) and IEAVXECR. 


Exit to: Not applicable (This module does not contain 
executable code.) 


IEAVXPAM — PC/AUTH Resource Manager 


Operation: When an address space or a task that owns a 
cross memory resource is being terminated, this module 
receives control to recover the PC/AUTH resources. 
It: 


‘© Resets the authorization index, authorization table 
origin, and the linkage table designator of the 
terminating address space or task. 


e Disconnects the address space from any cross 
memory services available to it, except those 
available via the system linkage table (SLT). 


e Frees the PC/AUTH resources owned by the 
terminating address space or task. 


Entry from: 
For entry point IEAVXPAM: IEAVTSKT via a PC 


instruction issued by the PCARM macro 
JEAVTMMT. 
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For entry point IEAVXCOC (cleanup exit): 
PC/AUTH service routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 

Error exit: RTM via an ABEND macro. 

Called routines: TEAVEBBR. 

TIEAVXPCR — PC/AUTH Service Routines’ FRR 


Operation: This module provides recovery for the 
program call/authorization (PC/AUTH) service 
routines and for itself. 


Entry from: TEAVTRTS (RTM) by issuing an LPSW 
instruction. 


Exit to: RTM by issuing a BR 14 instruction. 
Error exit: RTM by issuing a BALR instruction. 


Called routines: TEAVEQV]1 (single-threaded queue 
verification routine), EAVEQV3 (double-threaded 
queue verification routine), EAVXC01 (cleanup exit 
for IEAVXLRE), IEAVXC02 (cleanup exit for 
IEAVXLFR), IEAVXC03 (cleanup exit for 
IEAVXECR), IEAVXCO05 (cleanup exit for 
IEAVXECO), IEAVXC07 (cleanup exit for 
IEAVXARE, IEAVXCOA (cleanup exit for 
IEAVXAXS, IEAVXCOB (cleanup exit for 
IEAVXATS, IEAVXCOC (cleanup exit for 
IEAVXPAM). 


IEAVXRFE — PC/AUTH Service Routines that 
Reserve, Free, or Extract an Authorization Index 


Operation: This module performs three cross memory 
authorization functions. It: 


e Reserves one or more authorization indexes (AXs) 
for the home address space (entry point 
IEAVXARE) 

e Frees one or more AXs (entry point IEAVXAFR) 

e Extracts the AX value of a specified address space 
and returns it to the caller (entry point 
TEAVXAEX) 

Entry from: 


For entry point IEAVXARE: Issuer of an AXRES 
macro via PC. 


For entry point IEAVXAFR: Issuer of an AXFRE 
macro via PC. 


For entry point IEAVXAEX: Issuer of an AXEXT 
macro via PC. 


For entry point IEAVXC07 (cleanup exit): 
PC/AUTH service routines’ FRR (IEAVXPCR). 


For entry point IEAVXC08 (cleanup exit): 
PC/AUTH service routines’ FRR (IEAVXPCR). 


Exit to: Caller by issuing a PT instruction. 
Error exit: RTM via an ABEND macro. 


IEAVXSEM — See OS/VS2 System Initialization Logic 
for a module description of IEAVXSEM. 


IEAVXSET — PC/AUTH Service Routines that Set an 
Authorization Table Entry or an Authorization Index 


Operation: This module performs four functions: 


e Sets an authorization table (AT) entry for the 
caller’s home address space (entry point 
IEAVXATS) 


e Sets an authorization index (AX) for the caller’s 
home address space (entry point IEAVXAXS) 


e Determines whether a specified address space is 
authorized to issue PT and SSAR instructions to 
another specified address space (entry point 
IEAVXACK) 


e Determines whether a specified address space has 
an AX value of 1 (entry point IEAVXACK) 


Entry from: 


For entry point IEAVXATS: Issuer of an ATSET 
macro. 


For entry point IEAVXAXS: Issuer of an AXSET 
macro. 


For entry point IEAVXACK: IEAVXEC0 via a 
BALR. 


For entry point IEAVXCOA (cleanup exit): 
PC/AUTH service routines’ FRR (IEAVXPCR). 


For entry point IEAVXCOR (cleanup exit): 
PC/AUTH service routines’ FRR (IEAVXPCR). 
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Exit to: Caller. 

Error exit: RTM via an ABEND macro. 

Called routines: IEAVEBBR. 

IEAVXSFM — System Function Table Module 
Operation: This module contains the system function 
table (SFT), which contains pre-allocated PC numbers 


for system-wide program call services. 


Entry from: Not applicable. (This module contains no 
executable code.) 


Exit to: Not applicable. (This module contains no 
executable code.) 


IEAVXSTK — PCLINK STACK, UNSTACK, and 
EXTRACT Service Routine 


Operation: This module performs the functions 
requested by PCLINK macros. It: 


e Creates a PCLINK stack element in which to save 
cross memory linkage information when entered 
via a PCLINK STACK macro 


e Removes element(s) from the PCLINK stack when 
entered via a PCLINK UNSTACK macro) 


e Returns information from a specified PCLINK. 
element when entered via a PCLINK EXTRACT 
macro 


Entry from: 


For entry point IEAVXSTS: Issuer of a PCLINK 
STACK SAVE=YES macro. 


For entry point IEAVXSTN: Issuer of a PCLINK 
STACK SAVE=NO macro. 


For entry point EAVXUNS: Issuer of a PCLINK 
UNSTACK SAVE=YES macro. 


For entry point IEAVXUNN: Issuer of a PCLINK 
UNSTACK SAVE=NO macro. 


For entry point IEAVXEXT: Issuer of a PCLINK 
EATRDEE macro. 


For entry point FRRFRSTK (FRR for PCLINK 
STACK processing: RTM. 
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For entry point FRRUNSTK (FRR for PCLINK 
UNSTACK processing): RTM. 


For entry point FRRUNSK2 (FRR for 
FRRUNSTK): RTM. 


For entry point RETRYUNS (retry routine for 
FRRUNSTK): RTM. 


Exit to: Caller. 


Error exit. RTM via an ABEND macro, or if the macro 
issuer specified an ERRET, to the ERRET. 


IECDAFMT — Data Management Control Block 
Formatter Mainline 


Operation: This module locates the data management 
control blocks associated with the TCB passed in the 
parameter list and determines if they are to be 
formatted. If they are, it calls the appropriate control 
block formatter for each data management control 
block. 


Entry from: TEAVAD01 or AMDPRUIM. 
Exit to: Caller. 


IECDAFT1 — Data Management Control Block Format 
Module 


Operation: This module formats either the DEB, DCB, 
or IOB passed in the parameter list depending on which 
entry is called. The DCB formatter determines the 
access method type and formats the DCB accordingly. 
It also returns this information to the caller for use in 
locating the IOBs. The IOB formatter also uses the 
access method information to format the IOB 
(ICB,LCB). All entry points send a return code to the 
caller indicating success or failure in formatting. In 
addition, the DCB formatter sets a return code 
indicating failure if the access method does not have 
IOBs to be formatted. 


Entry from: TECDAFMT at entry points IECDADCB, 
IECDADEB, IECDAIOB, and IECDAFT1. 


Exit to: Caller. 
IECIOFMT — IOS Control Block Formatter Mainline 
Operation: This module locates the IOS control blocks 


associated with the TCB passed in the parameter list 
and determines if they are to be formatted. If they are, 
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it calls the appropriate control block formatters for 
each IOS control block. 


Entry from: TEAVADO1 or AMDPRUIM. 

Exit to: Caller. 

IECIOFT1 — IOS Control Block Format Module 
Operation: This module formats the EXCPD(XDBA) 
passed in the parameter list or the UCBs passed in the 
parameter list. For UCBs it determines the UCB type 
and formats it accordingly. It sends a return code to the 


caller indicating success or failure in formatting. 


Entry from: IECIOFMT at entry points IECIOEXD 
and IECIOUCB. 


Exit to: Caller. 

IEDAY3 — LOGON Synchronization Module 
Operation: This routine synchronizes the LOGON 
process for TIOC by preventing memory creation from 
proceeding until the TIOC LOGON routine has fully 
initialized the ASCB. 

Entry from: IEEVWAIT. 

Exit to: TEEVEMCR. 

IEEAB400 — WTP Buffer Routine 

Operation. This module puts WTP messages into 
buffers and, if the messages are also WTO messages, 
issues the WTO macro. When the buffer becomes full, 
this module calls IEEAB401 to issue the WTPs. 

Entry from: IEFAB4FD, IEFAB4DD, IEFAB4E4. 
Exit to: Caller. 

Called routines: TEEAB401. 

IEEAB401 — WTP PUT Routine 

Operation: This module issues the PUT macro to write 
any WTP messages present in the buffer built by 
IEEAB400. 

Entry from: TEEAB400, IEFAB4A0, IEFAB4DD, 
IEFAB421, IEFAB4E4, IEFAB4E8, IEFBB401, 
IEFBB410. 


Exit to: Caller. 


Called routines: None. 


IEECB800 — DISPLAY/TRACK Command Common 
Processor 


Operation: This module builds the display for a 
DISPLAY A or TRACK A command. The display 
consists of system status information about active — 
tasks, jobs, and time sharing terminals. TRACK 
command requests appear on a graphics (screen) 
device. DISPLAY command requests appear on either 
a graphics or a paper device. 


Entry from: TEEVWAIT via ATTACH. 
Exit to: End of task. 
Called routines. TEECB801. 


IEECB801 — Issuer of WTO and TPUT for DISPLAY 
and TRACK Commands 


Operation. This module issues the multi-line WTO 
(MLWTO) or iterative TPUTs for the DISPLAY and 
TRACK commands. 

Entry from: TEECB800, IEECB804, IEECB808. 

Exit to: Caller. 

IEECB804 — DISPLAY R Command Processor 


Operation: This module displays on an operator’s 
console, the text for the following types of messages: 


e Messages awaiting replies (WTORs) 
e Immediate action messages 
e Eventual action messages 


Addresses of devices that need to be made ready or 
need operator intervention are also displayed. 


Entry from: Attached by IEEVWAIT. 

Exit to: Caller. 

IEECB805 — SET MPF Processor 

Operation: This module builds a sorted table of message 
IDs and message prefixes for messages that are to be 
suppressed. It initializes the table with entries from the 


MPFLSTxx SYS1.PARMLIB member, where xx is the 
operand specified on the SET MPF command. 
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Entry from: YEEMB811. 
Exit to: YEEMB811. 


Called routines: TEEMB878, IEEMB882, IEEO503D, 
IEFJSIMW. 


IEECB806 — TRACE Command (MT-ON, MT-OFF, 
STATUS operands) Processor 


Operation: This module syntax checks the command, 
passes control to IEEMB809 (if appropriate) via the 
IEETRACE macro, and issues a STATUS message. 
Entry from: TEEVWAITT via ATTACH. 

Exit to: End of task. 

IEECB807 — DISPLAY MPF Processor 


Operation: This module displays the entries in the 
current MPF table built by IEECB805. 


Entry from: TEECB808. 

Exit to. TEECB808. 

Called routines: TEECB808, IEEOS03D. 

IEECB808 — Command Routine 

Operation. This module routes control to the DISPLAY 
MPF command processor (IEECB807), the VARY 
global resource serialization command processor 
(TEECB921), or the DISPLAY global resource 
serialization command processor (IEECB922). It also 
provides the message service subroutine (MSGSERV), 
a secondary entry point in IEECB808, which the 
command processors call to: 

e Build a single line of a message 

e Issue a complete message 

e Free any remaining write parameter lists (WPLs) 
Entry from: IEEVWAIT. 

Exit to: TEEVWAIT. 

Called routines: TEECB860, IEECB801. 

IEECB809 — VARY Device Service Routine 
Operation: This module handles all 


ASSIGN/UNASSIGN and dynamic pathing processing 
for the MVS VARY Device command. 
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Entry from: TEECB862, IEE3103D. 

Exit to: TEECB862, IEE310D. 

Called routines: TECVDPTH, IEEMB814, IEFAUSRV. 
IEECB811 — Reply Syntax Checker 


Operation. This module validates the command syntax 
and ID and schedules an SRB for stage 2 processing. 


Entry from. TEECB808. 

Exit to: TEECB808. 

IEECB860 — Command ESTAE Creation/Exit Routine 
Operation: This module creates an ESTAE environment 
for the module that invokes it. If the ABEND STAE 
interface routine (ASIR) invokes the module, it 


provides a dump and messages. 


Entry from: ABEND STAE interface routine, 
IEECB808, IEECB913. 


Exit to. ABEND STAE interface routine. 

TEECB862 — VARY Device ESTAE Exit Routine 
Operation: This module is the ESTAE exit routine for 
VARY Online/Offline/Console processing. It updates 
the SDWA and takes an SVC dump. Then, if any 
device was assigned or had dynamic pathing done, but 
is not online, the device is unassigned and the path 
group is disbanded. TEECB862 then returns to RTM 
to percolate to IEECB860. 

Entry from: RT. 

Exit to: RTM. 

Called routines: TEECB809. 

IEECB866 — Console Dump 


Operation: This module causes a dump of virtual 
storage to the current dump data set SYS1.DUMP. 


Entry from: TEEVWAITT. 


Exit to: System through use of SVC 3. 
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IEECB900 — VARY CN Syntax Processor 

Operation: This module syntax checks the command 
and passes control to the authority processor for valid 
commands. 

Entry from: TEEVWAIT. 

Exit to: End of task. 

Called routines: TEECB901. 

IEECB901 — VARY CN Console Processor 


Operation: This module modifies a console authority 
value for eligible consoles. 


Entry from. IEECB900. 
Exit to: Caller. 
IEECB904 — VARY Range Processor 


Operation: This module creates a VARY command 
from a VARY device address-range command. 


Entry from: T1EE3603D, IEE3103D, IEE3303D, 
TEE4203D, IEE4603D. 


Exit to: Caller. 

TEECB905 — SLIP Command Processor 

Operation: This module sets, modifies, and deletes SLIP 
traps. It also schedules EAVTGLB to activate or 
deactivate PER monitoring. 

Entry from: IEEVWAIT via ATTACH. 

Exit to: SVC 3 via a BR 14 instruction. 

IEECB906 — SLIP ESTAE Routine 

Operation: This module provides ESTAE recovery for 
the SLIP command (IEECB905 and IEECB909), the 
DISPLAY SLIP command (IEECB907) and the SLIP 
message module (IEECB908). It cleans up resources 
and takes an SVC dump. It does not retry. 

Entry from: ABEND STAE interface routine. 


Exit to: ABEND STAE interface routine. 


IEECB907 — Display SLIP Processor 


Operation: This module displays SLIP traps either in 
summary or in detail in response to the DISPLAY SLIP 
operator command. If the SLIP command processor 
requests it, IEECB907 also provides detailed trap 
information. 


Entry from: 


e IEEVWAIT via ATTACH for DISPLAY SLIP 
e TEECB905 via BALR to show options 


Exit to: End of task if entered from IEEVWAIT, 
IEECB905 if entered from IEECB905. 


Called routines: 


IEECB860 via BALR and ESTAE exit 
ITEECB906 via ESTAE exit 
TEECB908 via BALR 

TEEO503D via BALR 


IEECB908 — SLIP Message Module 

Operation: This module contains SLIP messages. It 
formats and writes out the message requested and if the 
message demands a response, waits for a reply. It also . 
posts IEECB914 to converse with a TSO SLIP user. 
Entry from: TEECB905 and IEECB907. 

Exit to: Caller. 

IEECB909 — SLIP Command Interpreter 


Operation: This module scans and interprets all SLIP 
command input text. 


Entry from: IEECB905 via BALR. 

Exit to: Caller. 

IEECB910 — Display Dump Processor 

Operation: This module produces the IEE856I and 
IEE857I message output in response to the operator 
command DISPLAY DUMP. 

Entry from: TEEVWAIT. 


Exit to: Caller. 
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IEECB911 — Display Dump Message CSECT 
Operation: This CSECT contains the message text that 
IEECB910 uses to construct the lines for its output 
messages. 

Used by. TEECB910. 

IEECB912 — Display Dump MLWTO Interface 


Operation: This subroutine converts lines of output into 
MLWTO format. 


Entry from: TEECB910. 

Exit to: Caller. 

IEECB913 — SETSMF Processor 

Operation. This module changes one or more individual 
SMF options as requested in the SETSMF command. 
In addition, it issues an SSI call to the subsystems 
whose options have been modified. 

Entry from: TEEVWAIT via an ATTACH. 

Exit to: TEEVWAIT. 


Called routines: TEECB860, IEEMB821, IEEMB823, 
TEEBM824, IEEMB829, IEFJSREQ via a BALR. 


IEECB914 — SLIP TSO Communication Routine 


Operation: This module issues a TPUT and TGET to 
the SLIP TSO user. 


Entry from: IKJEFFOO via ATTACH. 

Exit to: SVC 3 via BR14. 

IEECB915 — SLIP Processor POST Routine 
Operation: When it is scheduled by the SLIP processor 
(IEAVTSLP), this module posts the SLIP command 
processor (IEECB905). The posting is done when the 
SLIP processor requests message processing. 

Entry from: SRB dispatcher. 

Exit to: Caller. 

IEECB916 — Display SMF Processor 


Operation: This module lists SMF data set status and 
the SMF options currently in effect. 
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scheduler). 
Exit to: Caller. 


Called routines: TEEMB824, IEEMB833, IEECB860 
via BALR. 


IEECLEAN — Vary CPU/Channel Cleanup and 
Recovery Routine 


Operation: For the Vary CPU/channel function, this 
routine issues messages and frees the system resources 
including storage for recorder blocks and SMF records. 


Entry from: IEEVCPR. 
Exit to: Caller. 


IEECVETA — CONTROL Command Syntax Checker 
(DIDOCS) 


Operation: Checks the syntax of the CONTROL 
command. 


Entry from: IEECVET1, IEECVET4. 
Exit to: 


e JTIEECVETK if roll mode or RTME (time interval 
specification) changes 


e IEECVETD to issue warning message 


e IEECVETH/P/R/U (device-dependent I/O 
modules) to rewrite the entry area 


e IEECVETD to issue an error message 


IEECVETC — Asynchronous Error Processing Module 
(DIDOCS) 


Operation: This module initializes the DCM for a 
reopen. It processes asynchronous errors and prepares 
for a console switch after a permanent synchronous 
error. 


Entry from: 
e TEECVET1 for asynchronous error processing 


e JEECVFTG for asynchronous error processing 
¢ JEECVET4 for asynchronous error processing 
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Exit to: 

e TIEECVETE to issue error message 

e IEECVFTG to assist in error processing 
e JEECVETK to set timer interval 


« IEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen image 


e IEAVSWCH to perform console switch 


e JEECVET4 to simulate pressing the CLEAR key if 
the device supports the erase-write-alternate 
(EWA) command 


IEECVETD — Message Module (DIDOCS) 


Operation: For full capability consoles, places error or 
informational messages in the warning line or the 
instruction line; for message stream or status display 
consoles, places messages in the warning line. 


Entry from: Any DIDOCS module detecting a 
message-output condition. 


Exit to: 


e IEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen. 


e JTEECVET!1 if hold mode is in effect. 


e JTEECVETS if roll mode is in effect and an 
unviewable message is needed. 


IEECVETE — Message Module (DIDOCS) 


Operation: Places messages into the instruction or 
warning line and places asynchronous error messages 
into the entry area. 


Entry from: 


ITEECVETC to issue asynchronous error message 
IEECVET4 to issue error message 
IEECVETK to issue error message 
IEECVETF to issue error message 
IEECVET6 to issue error message 
IEECVETS to issue error message 


Exit to: TEECVETH/P/R/U (device-dependent I/O 
modules) to write messages to the screen. 


IEECVETF — Light-Pen and Cursor Detect Analyzer — 
(DIDOCS) 


Operation: Determines from the location of a light-pen 


or cursor detect what function is being requested. 


Entry from: TEECVET1. 
Exit to: 


e IRECVET4 if detect occurred in out-of-line 
display. 


« IEECVETH/P/R/U (device dependent I/O 
modules) to process ENTER. 


e TEECVFTA to process PFK line detect. 
e IRECVETS to process delete request. 


e TEECVETS to process verification of a delete 
operation. 


e IEECVETD to issue _— message. 

: IEECVETE to issue error message. 

e IEECVET!1 to route ENTER for 3277 device. 
IEECVETG — Open/Close Module (DIDOCS) 


Operation: Performs open and close processing for 
cathode ray tube devices used as consoles. 


Entry from: 

e IERECVET1 if open pending. 

e JTEECVETK after it removes the console from roll 
mode. : 


Exit to: 


e JEECLCTX if device was opened for console 
switch. 


e JEECVET1 after open to perform other 
communications task operations. 


e IEECVFTG to complete close of a console. 


« JEECVETK to remove console from roll mode 
before close. 
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IEECVETH —~ 3066 Device I/O Module (DIDOCS) 


Operation: Performs input/output operations to 3066 
devices used as operator consoles. 


Entry from: Any DIDOCS module that modifies the 
SB. 


Exit to: 


e IBECVET1 after I/O has been initiated. 
e IEECVFTG if status switch must take place. 


IEECVETJ — Roll Mode Processor (DIDOCS) 


Operation: Rolls messages off the console screen based 


on a timer interval and the number of lines to be rolled. 


Entry from: TEECVET1. 
Exit to: 


e IEECVETK to display the number of messages 
waiting to be displayed. 


e IEECVET2 to handle timer supervision if no roll 
occurred and to display messages if space exists in 
the message area. 


IEECVETK — Timer Interpreter (DIDOCS) 


Operation: Resolves the different time intervals at 
which roll is to occur for different CRT consoles. 


Entry from: 
e JIEECVET1 if timer expires. 


e TIEECVETC to reset time interval after an 
asynchronous error. 


e JEECVETG to remove a console from roll mode 
before closing the console. 


¢ JTEECVETA if roll mode or RTME (time interval) 
changes occur. 


e JTEECVFTR to set the timer. 
Exit to: 
e IEECVET2 to display message after roll. 


e IEECVETE to display error message. 
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e JEECVETD to display warning message. 
¢ IEECVETG to close the device. 


e IRECVETH/P/R/U to write the screen image on 
the console screen. 


e IBECVET1 if no roll is to occur. 


IEECVETP — 2250 Device I/O Module - Part 1 
(DIDOCS) 


Operation: Performs I/O operations to 2250 devices 
used as operator consoles. 


Entry from: Any DIDOCS module that modifies the 
SIB. 


Exit to: 


IEECVET1 after I/O has been initiated. 
IEECVETF if light-pen or cursor detect occurs. 
IEECVFTG for a status switch. 

IEECVETQ to complete I/O operations. 


IEECVETQ — 2250 Device I/O Module - Part 2 
(DIDOCS) 


Operation. Performs I/O operations to 2250 devices 
used as operator consoles. 


Entry from: TEECVETP. 
Exit to: TEECVET1 after I/O is initiated. 


IEECVETR — 2260 Device I/O Module - Part 1 
(DIDOCS) 


Operation: Performs I/O operations to 2260 devices 
used as operator consoles. 


Entry from: Any DIDOCS module that modifies the 
SIB. 


Exit to: 


IEECVET1 after I/O is initiated 
IEECVFTR for status switch 
IEECVET4 if cancel occurs 
IEECVETF if cursor detect occurs 
IEECVFTR to complete I/O operations 
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JEECVETU — 3270 Device and Model 158 System 
Console I/O Module - Part 1 (DIDOCS) 


Operation: Performs I/O operations to 3270 display 
devices used as operator consoles. 


Entry from: Any DIDOCS module that modifies the 
SIB. 


Exit to: 


¢ IEECVET1 after I/O is initiated 

e IEECVETF if light-pen or cursor detect occurs 
outside entry area 

e IEBECVFTG for a status switch 

e TRECVETK for roll mode 

e JIEECVETYV to complete I/O operations. 


IEECVETV — 3270 Device I/O Module - Part 2 
(DIDOCS) 


Operation: Performs I/O operations to 3270 display 
devices used as operator consoles. 


Entry from: TEECVETU. 
Exit to. TEECVET1 after I/O has been initiated. 


IEECVETW — 3284/3286 Console Device Support 
Processor 


Operation: Performs the following functions for 
3284/3286 printers used as a console: 


e« Opens the 3284/3286 as a console. 


e Initiates a write operation to write messages to the 
console. 


e After a write operation completes successfully, 
updates the console queue. 


e When the 3284/3286 printer is to be removed from 
console status, closes the console. 


Entry from: TEAVVCTR. 
Exit to: 
e IEAVSWCH if an I/O error occurs or the console 


cannot be opened. 
e Issuer of SVC 72, otherwise. 


IEECVET1 — DIDOCS Router Module 


Operation: Passes control to DIDOCS modules on the 
basis of requested function. 


Entry from: EAVVCTR, IEECVETO, IEECVETV, 
IEECVFTR, and IEECVFTB. 


Exit to: 


IEECVETG for console open and close 

IEECVETC for asynchronous error processing 

IEECVET4 for command processing 

IEECVET2 for message output 

IEECVET7 for message deletion 

IEECVETS9 for message deletion 

IEECVFTP for erasing a status display or stopping 

a dynamic display 

IEECVETY for roll 

IEECVETK for timer processing | 

IEECVFTM for out-of-line message output 

IEECVETF for light-pen or cursor detect 

IEECVETH/P/R/U (device-dependent I/O 

modules) to perform I/O 

IEECVFTA for PFK attention 

IEECVFTL for in-line message output 

IEECVFT1 for PFK redefinition 

IEECVFTT for display area blanking 

IEECVETD to issue error messages 

IEECVET6 for routed CONTROL E commands 

IEECVETS for routed CONTROL E/CONTROL 

E,SEG commands 

« JEECVETA for routed CONTROL S commands 

e TIEECVFTB for routed CONTROL 
D,PFK/CONTROL E,PFK/CONTROL N 
commands 

e IEECVFTN for routed CONTROL 
D,F/CONTROL D,U/CONTROL D,H 
commands 

e IEAVVCTR to return to the caller 


IEECVET2 — In-line Message Output Module 
(DIDOCS) 


Operation: Controls the output of in-line messages. 
Entry from: 


« IEECVFT2 to determine exit from message output 
modules after single-line message output. 


e IEECVET1 to display a message. 


« JEECVFTL to determine exit from message output 
modules after multiple-line message output. 
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e IEECVETY] to display a message after roll. 
e JEECVETK to display a message after roll. 


e IEECVETS to display a message after automatic 
deletion occurs. 


Exit to: 


¢ TEECVETH/P/R/U (device-dependent I/O 
modules) to write messages to the screen. 


e JEECVET1 if there were no messages to display. 
e JEECVETD to issue a warning message. 
e IEECVFT2 to move messages to the DCM. 


« IEECVET7 to delete INTERVENTION 
REQUIRED messages. 


e JEECVETS9 for automatic deletion of messages. 
IEECVET3 — Message Output Module (DIDOCS) 


Operation: Issues STIMER for roll mode after roll has 
been initialized. 


Entry from: IEECVET2 to issue STIMER for roll 
mode. 


Exit to: 


e JIEECVET1 if no I/O is to be performed after 
STIMER. 


e IEECVETD if ’unviewable message’ warning line is 
requested. 


« JEECVETH/P/R/U (device-dependent I/O 


modules) to write the screen image on the console 
screen. 


IEECVET4 — Command Analyzer (DIDOCS) 
Operation: Analyzes command input and routes the 
command to other DIDOCS modules or to the system 
for processing. 

Entry from: 

e TEECVET1 to process command input 


e IEECVETF to process a cancel key or light-pen 
detect on a cancel function 
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e TIEECVETR to perform the cancel function 


e IEECVFTA to issue the command that PFK 
processing placed in the entry area 


e IEECVETC to simulate pressing the CLEAR key 
Exit to: 


e JIEECVETC to complete asynchronous error | 
processing. 


e JTIEECVETS to initialize message deletion. 
¢ IEECVETS to process delete verification. 
e JEECVET!1 after command processing is complete. 


e JEECVETH/P/R/U (device-dependent I/O 
modules) to rewrite the screen. 


e JYEECVETD for repeat last command processing. 


e The appropriate CONTROL command processing 
modules (IEECVET6, IEECVETS8, IEECVET9, 
IEECVETA, IEECVFTB, IEECVFTN, or 
IEECVFTP). 


IEECVET6 — Message Deletion Module (DIDOCS) 


Operation: Deletes messages requested by the K E,F or 
K E,nn(,nn) command. 


Entry from: TEECVET1, IEECVET4. 
Exit to: 


e IEECVETS to remove messages 
e JEECVETD for message verification 
e JTRECVETE to issue error messages 


IEECVET7 — Message Deletion Module (DIDOCS) 


Operation: Deletes INTERVENTION REQUIRED 
messages and messages requested by DOM. 


Entry from: 


e IEECVET1 
e IEFECVET2 
e IRECVFT2 
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Exit to: 


¢ IEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen 


« IEECVETS9 to attempt automatic deletion 
e JTEECVET1 on NOP entry 
IEECVET8 — Message Deletion Module (DIDOCS) 


Operation: Deletes messages requested by the K E,SEG 
command, a cursor detect, or a light-pen detect. 


Entry from: 


e JEECVETF to process a light-pen or cursor detect 


e JEECVET4 to process the K E,SEG command 

e JEECVET1 for routed K E/K E,SSEG commands 
Exit to: 

« IEECVETS to remove messages from the screen. 
e JTIEECVETD to issue a verification message. 


e TEECVETE to issue NO DELETABLE 
MESSAGE message. 


IEECVET9 — Message Deletion Module (DIDOCS) 
Operation: Processes automatic deletion when the 
screen is full, numbers messages in response to the K 
D,N command, and deletes messages in response to a K 
command. 

Entry from: 

« JEECVET4 to process the K D,N command. 


e IEECVET6 to delete messages if no verification is 
necessary. 


e TIEECVET7 to perform automatic deletion. 


e IEECVET2 to perform automatic deletion if screen 
is full. 


Exit to: 


e IEECVET2 after automatic deletion. 
e IEECVETD to issue error messages. 


e IEECVETH/P/R/U (device-dependent I/O 
modules) to rewrite the screen. 


IEECVFTA -—~ PFK-Entered Command Processor 
(DIDOCS) 


Operation: Processes automatic command entry that 
results from a depressed PFK or a light-pen detect on 
the PFK line. 


Entry from: 


e IEECVET4 for depressed PFK 
« JTEECVETF for light-pen detect on the PFK line 


Exit to: 


» IEECVET4 to process an entered command 
(nonconversational mode). 


e IEECVETH/P/R/U (device-dependent I/O 
modules) to write the command to the entry area 
of the screen (conversational mode). 


e JEECVFTD to issue error messages. 


IEECVFTB — PFK Definition Processor (K D,PFK/K 
E,PFK/K N,PFK) (DIDOCS) 


Operation: Processes 2 PFK definition or redefinition in 
response to the K N,PFK command; displays or erases 
the PFK line in response to the K E,PFK or K D,PFK 
command. 


Entry from: TEECVET1, IEECVET4. 
Exit to: 


e JIRECVETH/P/R/U (device-dependent I/O 
modules) to write or erase the PFK line. 

e JTEECVFT1 when a PFK is defined. 

¢ JEECVETD to write error messages. 

¢ JEECVFTD to write error messages. 


IEECVFTD — Message Module (DIDOCS) 


Operation: Prepares for the writing of informational or 
error messages. 


Entry from: TEECVFTA and IEECVFTB. 


Exit to: TEECVETH/P/R/U (device-dependent I/O 
modules) to write messages to the screen. 
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IEECVFTG — DIDOCS Cleanup Module 


Operation: Finishes functions that involve a system 
interface. 


e If device is being closed, flags messages no longer 
needed. 


e If device is changing status to message stream or 
full capability, flags out-of-line messages on the 
console queue. 


e If device is changing status to status display, flags 
messages on console queue. 


e If device is recovering from asynchronous error, 
flags out-of-line messages on the console queue. 


e If this routine flags any out-of-line messages except 
for an asynchronous error, it stops a dynamic 
display, frees SACBs obtained with a GETMAIN, 
and resets the area definitions to their SYSGEN 
values. 

Entry from: 

e IEECVETG for open or close of a device 

e JEECVETC for an asynchronous error 


e IEECVETH/P/R/U (device-dependent I/O 
modules) 


e TIEECVFTR (device-dependent I/O module) 
Exit to: 


e JEECVET1 after close 
e JEECVETC after all processing other than close 


IEECVFTL — In-line Multiple-line Message Processor 
(DIDOCS) 


Operation: Controls the output of in-line, multiple-line 
messages (MLWTO). 


Entry from: 
e TEECVET1 
e JEECVFT2 
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Exit to: 
e JFEECVFT2 to process next WQE. 


e YTEECVET?2 if roll mode is in effect and the screen 
is full. 


e JEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen. 


e JEECVET1 if EECVFTL encounters the end of 
the MLWTO chain but not the end of the message. 


e JEECVETD to issue error messages. 


IEECVFTM — Out-of-line Multiple-line Message 
Processor (DIDOCS) 


Operation. Controls the output of out-of-line, 
multiple-line messages (MLWTOQO). 


Entry from: TEECVET1. 
Exit to: 
e IEECVFTO for display lines that overlay messages. 


e JEECVFTQ for display lines that do not overlay 
messages. 


e IEECVET1 if no more out-of-line messages are on 
the queue. 


e IEECVFTP for blanking of messages below a 
display. 


IEECVFIN — Status Display Processor (DIDOCS) 
Operation: Rewrites the display control line in response 


toa K D,F (framing), K D,H (holding), or K D,U 
(updating) command. 


Entry from: 


e IEECVET4 if console is a full-capability console. 
« JEECVET1 if console is a status-display console. 


Exit to: TEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen. 
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IEECVFTO — Status Display Processor (DIDOCS) 


Operation: Controls the output of a status display that 
overlays messages. 


Entry from: TEECVFTM. 


Exit to: TEECVETH/P/R/U (device-dependent I/O 
modules) to write three lines of the display area. 


IEECVFTP — Status Display Processor (DIDOCS) 
Operation: Controls the erasing of out-of-line displays. 
Entry from. IEECVET 1, IEECVET4. 

Exit to: 


¢ TEECVETH/P/R/U (device-dependent I/O 
modules) to write the console screen. 


e TIEECVFTT to blank the screen below the erased 
display. 


e JIEECVET1 for a NOP entry. 
IEECVFTQ — Status Display Processor (DIDOCS) 


Operation: Controls the output of a status display to an 
out-of-line area that does not overlay messages. 


Entry from: TEECVFTM. 

Exit to: 

« IEECVETH/P/R/U (device-dependent I/O 
modules) to write display lines to the screen. 

¢ IEECVFIM if no I/O is done. 

IEECVFTR — 2260 I/O Module - Part 2 (DIDOCS) 


Operation. Performs I/O operations to 2260 devices 
used as operator consoles. 


Entry from: TEECVETR. 

Exit to: 
IEECVFTG for cleanup. 
IEECVETK for setting the timer. 


IEECVETR for additional I/O processing. 
IEECVET1 if a status switch is not required. 


IEECVFTT — Status Display Processor (DIDOCS) 
Operation: Overlays with blanks any in-line message 
that is below an out-of-line display or between two 
out-of-line displays. 

Entry from: 


e TEECVET1 
e TEECVFTM 


Exit to: TEECVETH/P/R/U (device-dependent I/O 
modules) to write the screen. 


IEECVFT1 — PFK Definition Processor (DIDOCS) 

Operation: Updates PFK definitions in SYS1.DCMLIB. 

Entry from: TEECVET1. 

Exit to: 

e JEECVET1 after I/O to SYS1.DCMLIB has been 
initiated. 

e IEECVETH/P/R/U (device-dependent I/O 
modules) to blank the entry area. 


IEECVFT2 — Single-line Message Processor 
(DIDOCS) 


Operation: Displays and marks both action and 
deletable messages; locates and routes nondisplayed 
multiple-line messages (MLWTOs). 

Entry from: 


e TEECVET2 to move messages to the DCM. 
e IEECVFTL to process the next WQE. 


Exit to: 

« IEECVET2 to continue output queue scan. 

e JIEECVFTL to process in-line, multiple-line 
messages. 


IEEC2740 — 2740 Console Device Support Processor 


Operation: Performs the following functions for a 2740 
communications terminal used as a console. 


e Opens the 2740 communications terminal as a 
console. 


e Uses BTAM to read a command from the console. 
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e After a read operation completes successfully, 
passes the command to command processing (SVC 
34). 

e Uses BTAM to write messages to the console. 


e When the 2740 communications terminal is to be 
removed from console status, closes the console. 


Entry from: IEAVVCTR. 

Exit to: 

e IEAVSWCH if an I/O error occurs or the console 
cannot be opened. | 

e Otherwise IEAVVCTR. | 

IEEDISPD — Display Domain Processor 


Operation. Writes a console display of entries in the 
Domain Descriptor Table. — 


Entry from: TEEVWAIT. 

Exit to: End of Task. 

IEEJB840 — See IGC0203E 

IEEMB803 —- System Log Initialization/Writer Module 
Operation: This module initializes the system log, opens 
and closes the log data set, and writes the log buffers to 
the log data set. 


Entry from: TEEVWAIT. 


Exit to: None - always available through waiting on 
ECB. 


IEEMB804 — Write-To-Log (WTL) Processor — 
SVC 36 


Operation: This module processes all valid WTL 
requests. 


Entry from: IEE1603D. 
Exit to: IEE1603D. 
IEEMB805 — System Log Resource Initialization 


Operation: This module acquires and initializes log 
resources used through log activation. 
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Entry from: TEEMB803. 

Exit to: TEEMB803. 

IEEMB806 — System Log ESTAE Processor 
Operation: This module sets up two ESTAE 
environments for the system log, and it processes 
system log task ABEND situations. (The second 
ESTAE handles abnormal terminations of the first 
ESTAE). 

Entry from. TEEMB803 (ESTAE/ABEND interface). 
Exit to: ESTAE/ ABEND interface. 

IEEMB807 — System Log Message Module 


Operation: This module issues messages for the system 
log task. 


Entry from: TEEMB803, IEEMB806. 
Exit to: Caller. 
IEEMB808 — Master Trace Data Entry Routine 


Operation. This module adds entries to the master trace 
table. 


Entry from: IEETRACE macro processing. 
Exit to: Caller. 


IEEMB809 — Master Trace Create/Deactivate 
Routine 


Operation: This module initializes a new master trace 
table or deactivates an existing master trace table. 


Entry from: TEETRACE macro processing. 
Exit to: Caller. 
IEEMB810 — Performance Group Reset Module 


Operation. This module passes performance group reset 
parameters to the system resources manager (SRM). 


Entry from: TEEVWAIT. 


Exit to: End of task. 
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TEEMB811 — SET Keyword Scanner 

Operation: This module scans for various SET keywords 
and passes control to the appropriate keyword 
processor. 

Entry from: TEEVWAIT. 

Exit to: End of task. 


IEEMB812 — SET IPS, Installation Control 
Specification, OPT Processor 


Operation: This module invokes a list processor to 
process the data in the appropriate parmlib member 
(TEAIPSxx, IEAICSxx, or IEAOPTxx). It also notifies 
the system resources manager of the changes. 

Entry from: TEEMB811. 

Exit to: TEEMB811. 

IEEMB813 — UNLOAD Command Syntax Scanner 


Operation: This module scans the information in the | 
UNLOAD command and validates the syntax. 


Entry from: IEEVWAITT. 
Exit to: End of task. 
TEEMB814 — Message Module for Parmlib Process 


Operation: This module issues messages for IEEMB81 1 
and TIEEMB878. 


Entry from: TEEMB811 and IEEMB878. 
Exit to: Caller. 
IEEMB815 — CHNGDUMP Command Processor 


Operation: This module implements the CHNGDUMP 
operator command. IEEMB815 scans the operand 
portion of the command and updates the RTCT dump 
options lists. It fixes pages needed for the SUMDUMP 
option of SVC dump. If the NOSUMDUMP option is 
specified on the CHNGDUMP command, it frees 


pages. 
Entry from. TEEO403D via BALR. 


Exit to: TEEO003D. 


IEEMB816 — Master Trace Functional Recovery 
Routine 


Operation: This module performs error recovery for 
master trace routines IEEMB808 and IEEMB809. 


Entry from: RTM via FRR stack. 
Exit to: Caller of master trace. 
IEEMB820 — SMF Initialization Router Module 


Operation: This module performs the following 
functions: | 


e Initializes SMCA/STAE/ACT 

e Invokes SMF parameter processing 
Initializes SMF recording | 

Entry from: TEEMB860. 

Exit to: Caller. 


Called routines: TEEMB821, IREMB822, IEEMB823, 
TEEMB824 via BALR. 


TEEMB821 — SMF Input Merge Module 

Operation: This module processes the SYS1.PARMLIB 
member containing SMF options. It parses the values, 
prompts the operator for changes, and sets the resulting 
values in the SMCA. . 
Entry from: IEECB913, TEEMB820, IEEMB835. 

Exit to: Caller. 

Called routines: TEEMB832, IEEMB833, IFEMB824, | . 
IEEMB839 (ELEMENQ routine), IEEMB822 via 
BALR. 

TIEEMB822 — SMF Data Set Initialization 


Operation: This module prepares SMF data setsfor__ 
recording by: 


» Dynamically allocating the data sets specified in the 
data set parameter | 


e Pre-formatting the data:sets, if necessary . 
e Creating SMF buffers 


Entry from: TEEMB820 at IPL time; IEEMB835 at 
SET SMF time. 
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Exit to: Caller. 
Called routines: TEEMB824 via BALR. 
IEEMB823 — SMF Initialization Record Processor 


Operation. At IPL time, this module issues the four 
initialization record types (0, 8, 22, 90). It issues SVC 
78 to produce a fifth record (type 19). It completes 
SMF initialization for the master address space. 
Additionally, it prompts the operator for the IPL 
reason. 


At SET SMF and SETSMF time, this module produces 
a type 90 record containing the new SMF options. At 
SET SMF time, it also reinitializes SMF for the master 
address space. 


Entry from: TEEMB8720 at IPL time; IEEMB835 at 
SET SMF time to build record type 90; IEECB913 at 
SET SMF time to build record type 90. 


Exit to: Caller. 


Called routines: TEEMB824 via BALR; IEFSMFIE via 
LINK. 


TEEMB824 — SMF Message Processor Module 
Operation: This module builds and issues messages 
according to the parameters passed it by the caller. 
Messages issued are WTOs, WTORs, multi-line WTOs, 
and PUTs to a message data set. 

Entry from: TEECB913, IEECB916, IEEMB820, 
TEEMB821, TEEMB822, IEEMB823, IEEMB825, 
TEEMB827, IEEMB829, IEEMB831, IEEMB832, 
TEEMB833, IEEMB835, and IFASMFDP. 

Exit to: Caller. 

Called routines: References IEEMB826. 
IEEMB825 — SMF ESTAE Exit Routine 
Operation: If the SMF writer abends, this module 
performs recovery. Its functions include dump 
processing, message processing, and retry or SMF 
recording cleanup. 

Entry from: RTM. 

Exit to: Caller. 


Called routines: TEEMB824, IEEMB827 (global 
cleanup subroutine). 
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IEEMB826 — SMF Message Processor Language Parts 
Table 


Operation: This module contains translatable language 
parts which are used by IEEMB824 to build SMF 
messages. 

Entry from: Not applicable (non-executable code). 
Exit to: Not applicable (non-executable code). 
IEEMB827 — SMF Initialization ESTAE 

Operation. This module manages recovery from failures 
that occur during SMF initialization. Specifically, it 
sends messages to the operator, creates an SDUMP, 
and cleans up resources. 

Entry from: RT™. 

Exit to: Caller. 

Called routines: TEEMB824. 

IEEMB828 — SMF Message Processor Table 
Operation: This dummy CSECT is part of the SMF 
message processor, IEEMB824. It contains a series of 
indexes used by IEEMB8724 to locate messages. 

Entry from: Not applicable (non-executable code). 
Exit to: Not applicable (non-executable code). 
IEEMB829 — SMF Writer Task 

Operation: This module completes SMF initialization 
and then handles those parts of SMF recording that 
require TCB mode: 


e Completing the data set switch 


e Ensuring that SMF data sets were dumped by the 
operator as requested 


e Performing part of the processing for the SET SMF 
command 


e Handling I/O errors 


Entry from: TEECB913 via BALR, IEEMB860, via 
ATTACH. 
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Exit to: Caller. 
Called routines. TEEMB824, IEEMB839 via BALR. 
IEEMB830 — SMF Writer SVC 


Operation: This module places SMF records into the 
SMF buffers (VSAM control intervals). 


Entry from: 


For entry point IEEMB830: Issuer of a 
SMFEWTM macro. 


For entry point IGCO008C: SVC FLIH. 
Exit to: Caller. 
Called routines: TEASMFSP via BALR. 
IEEMB831 — SMF Syntax Analyzer Module 
Operation: This module is used by IEEMB832 to 
analyze input text and return a number corresponding 
to the data description. It also processes syntax and 
invalid option errors. 
Entry from: TEEMB832. 
Exit to: Caller. 
Called routines: TEEMB824 via BALR. 
IEEMB832 — SMF Queue Options Module 
Operation: This module parses the input text. If no 
errors are found, it adds the option to the SMF option 
chain. 
Entry from: TEEMB821 or IFASMFDP. 
Exit to: Caller. 
Called routines: TEEMB824, IEEMB83i via BALR. 
IEEMB833 — SMF List Options Module 
Operation: This module lists the SMF options currently 
in effect. The list is directed to the console in the case 
of IPL or SET; to SYSPRINT in the case of the dump 
program (IFASMFDP). 
Entry from: IEEMB821, IFASMFDP, or IEECB916. 


Exit to: Caller. 


Called routines: TEEMB824 via BALR. 

IEEMB834 — SMF Writer SRB 

Operation: This module takes the VSAM control 
intervals from the buffers and writes them out to the 
SMF data set. 

Entry from: Dispatcher (IEAVEDS0O). 

Exit to: Caller. 

Called routines: TEASMFSP via BALR. 

IEEMB835 — SMF SET Command Processing 
Operation: This module processes the SYS1.PARMLIB 
member specified by a SET command. It parses the 
new values and resets the SMCA values. If data sets 
are changed, it opens and closes the appropriate data 
sets. 

Entry from: TEEMB811. 

Exit to: TEEMB811. 


Called routines: TEEMB821, IEEMB822, IEEMB823, 
TEEMB8724, IEFJSREQ. 


IEEMB836 — Interval Data Collection Module 
Operation: This module is scheduled when the SMF 
interval timer for a job expires. Running in SRB mode, 
it builds and writes interval records (types 30 and 32). 
Entry from: Dispatcher (IEAVEDSO). 

Exit to: Caller. 

Called routines: TEFTB727, IEFTB728. 

IEEMB837 — SMF Option Tables 


Operation: This module consists of the following 
CSECTS: 


« SMFOPTAB - A table of valid keywords 


e SMFDEFLT - A table of SMF writer default 
options 


e DMPDEFLT -A table of default options for the 
SMF dump program (IFASMFDP) 
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Entry from: Loaded by IEEMB820; referenced in 
TEEMB821 and IFASMFDP. 


Exit to: Not applicable (non-executable code). 
IEEMB838 — SMF Macro Module 


Operation: This module performs the processing 
invoked by the SMF macros. 


Entry from. SMF macros: SMFEWTM, SMFRTEST, 
SMFDETAL, SMFINTVL, and SMFEXIT. 


Exit to: Caller. 
TEEMB839 — SMF Timer Program 


Operation: This module is branch entered by the caller 
to enqueue or dequeue timer elements. The module 
handles four types of processing: MAXDORM, 
STATUS, INTERVAL for each ASID, and dump 
detector. 


Entry from: TEEMB821, IEEMB829, IEEMB836, 
IEEMB842. 


Exit to: Caller. 


IEEMB842 — SMF MAXDORM and STATUS 
Processor 


Operation: This module performs STATUS and 
MAXDORM processing. For STATUS, it builds and 
writes the type 23 statistics record. For MAXDORM, if 
the current record has been in the SMF buffer longer 
than the interval specified by the MAXDORM 
keyword in the SMFPRMxx parmlib member, 
TEEMB842 schedules the SMF writer SRB to force the 
data to be written to the SMF data set. 


Entry from: Scheduled by IEEMB839 at the expiration 
of the MAXDORM and STATUS time intervals. 


Exit to: Caller. 
IEEMB846 — TSO Command Table for Accounting 


Operation: This module includes all commands counted 
in the SMF type 32 record. 


Entry from: Not applicable (non-executable code). 


Exit to: Not applicable (non-executable code). 
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IEEMB847 — SMF Message Language Part Table 
Operation: This dummy CSECT is contained in the 
SMF message processor language parts table, 
IEEMB826. 

Entry from: Not applicable (non-executable code). 
Exit to: Not applicable (non-executable code). 


IEEMB848 — SMF Dynamic DD Data Collector 
Module 


Operation: This module saves EXCP counts (1) for data 
sets dynamically unallocated and (2) for all data sets at 
dynamic deconcatenation/ concatenation. The counts 
are then available for the SMF type 30 record. 

Entry from: TEFDB4F9. 

Exit to: Caller. 

IEEMB860 — Master Region Initialization Routine 


See OS/VS2 System Initialization Logic for a module 
description of IEEMB860. 


IEEMB876 — SET Command Keyword Table 


Operation: This module contains the SET command 
keywords processed by IEEMB811. 


Entry from: TEEMB811. 
Exit to: TEEMB811. 
IEEMB877 — Pamnlib Variable Messages 


Operation: This module contains the messages for 
parmlib processing. 


Entry from: EEMB814. 
Exit to. TEEMB814. 
IEEMB878 — SYS1.PARMLIB Read Routine 


Operation: This module reads records from a specified 
member of SYS1.PARMLIB. 


Entry from: TEECB805, IEEMPDEV, IEFIJSIN2. 


Exit to: Caller. 
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IEEMB879 — Master Trace SVC Dump Exit 


Operation. This module is invoked by SVC dump and 
uses SVC dump services to dump the master trace table 
and its related control blocks. It schedules an SRB 
(IEEMB880) to run in ASID 1 and moves the master 
trace data to a common area buffer. It invokes the SVC 
dump exit output service (IEAVTSEO entry in 
IEAVTSDO) to write the master trace data on the 
dump data set. 


Entry from: TEAVTSDU via BALR. 
Exit to: Caller. 


TIEEMB880 — Master Trace Dump Exit Data Move 
Routine 


Operation: This module runs as an SRB in the address 
space containing the master trace table data. It is 
scheduled by IEEMB879 for every page of master 
trace data to be dumped. It moves one page (4K) of 
master trace data to a common buffer and then posts 
the ECB (via IEAVSY50) that IEEMB879 is waiting 
on. 


Entry from. Dispatcher (IEAVEDSO) as an SRB 
scheduled by IEEMB879. 


Exit to: TEAVEDSO. 
TEEMB881 — System Address Space Create Routine 


Operation: This module creates a system address space 
either before or after master scheduler initialization is 
complete. The address space can be created with a 
limited-function start or a full-function start. If it is 
created with a full-function start, JEEMB881 passes 
the START parameters (input to IEEMB881) to the 
START command syntax check routine (IEEVSTAR). 


Entry from: TIEEVIPL, a resource initialization module 
(RIM), or any other module in supervisor mode. 


Exit to: Caller. 


Called routines. TEAVEMCR, IEAVEMRQ, 
IEEVWAIT. 


Entry point EAESTAE: This routine receives control if 
an ABEND occurs during system address space create 
processing. It fills in the SDWA (if one exists), takes a 
dump, and passes control to RTM, which attempts a 
retry at entry point EARETRY. 


Entry from: RT™. 

Exit to: RTM. 

Entry point EARETRY: This entry point sets the return 
and reason codes, releases storage for the CSCB, 
terminates the address space (if one was created), and 
terminates the ESTAE. 

Entry from: RTM. 

Exit to: Caller of IEEMB881. 

IEEMB882 — Positional Parser Routine 

Operation: This module syntax checks a record using a 
rules list associated with the record. The rules list 
specifies the number of parameters in the record along 
with the minimum and maximum length of each 
parameter. It also indicates if the parameter is optional 
and if it can be enclosed in apostrophes. 

Entry from: TEECB805, IEEJSIN2. 

Exit to: Caller. 


IEEMB883 — System Address Space Initialization 
WAIT/POST Routine 


Operation: This module waits for an event (indicated by 
the event code passed as input) to complete. If event 
code 1 is specified, IEEMB883 waits for master 
scheduler initialization to complete. 


Entry from: I[ATINXM, IEAVTSAI, IEAVXMAS, 
TEEPRWI2, IEFAB4I1, ISGNASIM. 


Exit to: Caller. 

Entry point WPESTAE: This entry point receives control 
if an abend occurs during IEEMB883. It fills in the 
SDWA (if one exists) and takes a dump. 

Entry from: RTM. 

Exit to: RT™.. 

Entry point WPRETRY: This entry point receives 
control from RTM following the execution of 
WPESTAE. It sets return and reason codes. 

Entry from: RT™4.. 


Exit to: Caller of EEMB883. 


Module Descriptions 11-73 


IEEMB884 — Scheduled Commands Table 

Operation: This module contains a table consisting of 
the verb code, module name of the command 
processor, and the target execution address space for 
each scheduled command. 

Entry from: N/A. 

Exit to: N/A. 

IEEMPDEV — Display Deviation Processor 
Operation: This module compares the configuration 
described in the CONFIXxx member of 
SYS1.PARMLIB with the actual system configuration 
and displays any differences to the operator. 

Entry form: TEEMPDM. 

Exit to: Caller. 

IEEMPDM — DISPLAY Matrix Command Processor 
Operation: This module displays, to the operator, the 
following information: status of processor, channel, and 
device paths; high storage address; storage status 
(on/off line). 

Entry from: TEEVWAIT. 

Exit to: Caller. 

IEEMPS03 — QUIESCE Command Processor 


Operation: This module suspends system activity by 
calling the load-wait-state processor (IEEVLDWT). 


Entry from: TEEVWAIT. 

Exit to: Caller. 

IEEMPVST — VARY Storage Processor 

Operation: This routine either makes a contiguous range 
of 4K blocks of storage available online or takes a 
range of blocks offline. 

Entry from: TEEVWAIT via ATTACH, IEEVSTOR. 
Exit to: Caller. 


IEEPALTR — SVC 110 Interface 


Operation: This routine issues SVC 110 for DISPLAY 
U, DISPLAY C,K, or DISPLAY PKF commands. 
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Entry from: TEEVWAIT via ATTACH. 
Exit to: Caller. 
IEEPRTN2 — STC Free Region Routine 


Operation: This module determines if there is a CSCB 
in existence at the end of started task control 
processing. If there is, IEEPRTN2 frees the CSCB. 


Entry from: TEESB605, TEEPRWI12, TEEVMNT1, 
TEEVSTAR, or IKJEFLA via XCTL. 


Exit to: Region control task via SVC 3. 
IEEPRWI2 — STC Get Region Routine 


Operation. This module gets a new region for started 
task control processing. If a system component address 
space is being created, this routine invokes the address 
space initialization routine. It also determines whether 
a START, MOUNT, or LOGON command is being 
processed, and based on that decision invokes the 
appropriate command processor. 


Entry from: IEAVAROO by means of ATTACH. 


Exit to: TEEVSTAR, TEEVMNT1, IKJEFLA, or 
IEEPRTN2. 


Called routines: TEEMB883 via BALR, a system 
address space initialization routine via LINK, IFAESIL 
via LINK. 


IEESB601 — SWA and TIOT Initialization for Private 
Catalog Processing 


Operation: This module creates an SWA control block 
structure for use by the dynamic allocation routines. 
These routines are invoked to process private catalogs 
for START, MOUNT, and LOGON commands. 
Entry from: TEESB601 via BALR. 

Exit to: TEESB601 via branch. 

IEESB605 — Job Scheduling Subroutine 

Operation: This module sets up the environment 


necessary to initiate a START, MOUNT, or LOGON 
command task. It builds the SSOB, SSIB, local job 
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scheduling parameter lists, and an SWA structure for 
the task; then it invokes the initiator. When initiator 
processing is done, JEESB60S5 deletes the SWA 
structure it created and frees the CSCB for the task. 


Entry from: TEEVJCL via XCTL for a START or 
MOUNT command, or IKJEFLB for LOGON 
commands. 


Exit to: IEFSD060, an initiator routine via LINK, to 
initiate the command task; IEEPRTN2 via XCTL, for 
end processing of aSTART or MOUNT command; or 
TEEPRTN2 via XCTL, for end processing of LOGON 
commands. 


IEESB606 — STC Get JSCB Routine 


Operation: This routine builds a JSCB during storage 
initialization for a START, MOUNT, or LOGON 
command. 


Entry from: TEAVEMIN via CALL. 
Exit to: Caller. 
IEESB665 — STC Recovery Exit Routine 


Operation: This module schedules a retry of STC when 
one of the following conditions has occurred: 


e A program check 
e A machine check 

e An ABEND 

e Depression of the RESTART key on a console 


If percolation from a lower level recovery routine has 
occurred, IEESB665 continues percolation. 


Entry from. Recovery termination management via 
LINK. 


Exit to: Caller via branch. 


IEESB670 — Job Scheduling Subroutine Recovery Exit 
Routine 


Operation: This module schedules a retry of IEESB605 
when one of the following conditions has occurred: 


A program check 

A machine check 

An ABEND 

Depression of the RESTART key on a console 


If percolation from a lower level recovery routine has 
occurred, IEESB665 continues percolation. 


Entry from: Recovery termination management via 
LINK. 


Exit to: Caller via branch. 

IEESTPRS — Stop/Restart Subroutine 

Operation: This module stops the operating system in a 
manner that allows a restart interruption to bring the 
system back into operation. This module runs on one 
processor and stops all others. 

Entry from: IEEVLDWT and any routine in supervisor 
state that wants to put the system into a restartable 
state. 

Exit to: Caller. 

IEEVALST — Validate Page Routine 


Operation: This module sets to zero the storage and 
storage key of a 4K section of real storage. 


Entry from: TEEMPVST, IEEVSTGL. 
Exit to: Caller. 


IEEVCPR — Processor/Channel Reconfiguration 
Processor 


Operation: TEEVCPR physically and logically adds or 
removes a processor and/or channel(s) to or from the 
system. 

Called by: TEEVCPU. 

Exit to: Caller. 

Error exit: RTM via an ABEND macro. 


Called routines: TEEVCPRL, IEECLEAN, and 
ITEEVMESS. 


IEEVCPRL — Processor/Channel Logical 
Reconfiguration Module 


Operation. TEEVCPRL performs the functions required 
to make a processor and/or channel(s) logically 
available or unavailable to the system. 


Called by: TEEVCPR. 
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Exit to: Caller. 
Error exit. RTM via an ABEND macro. 


Called routines: AHLVCON, AHLVCOFF, 
IEAVRTOD, IEAVRSSC, IEAVSPSA, IEAVTSIN, 
IECVCINT, IECVCRHA, IECVCRHD, IECVCRHV, 
IECVIOPM, IEEVDEV, IEEVMESS, IEEVWKUP, 
IEFAB49C, IEFENFFX, IGCO009A, IGC0407B, or 
IGFPBUCR. 


IEEVCPU — VARY CPU/CH Command Processor 
Operation. TEEVCPU controls VARY CPU/CH 
command processing. It parses the command, calls 
IEEVCPR to perform the requested reconfiguration, 
and writes the reconfiguration messages after 
IEEVCPR returns control. 

Called by. The master scheduler (IEEVWAIT) via an 
ATTACH macro after the operator issues a VARY 
CPU/CH command. 

Exit to: Caller. 

Error exit: RTM. 

Called routines: TEEVMESS and IEEVCPR. 


IEEVDCCR ~— Disabled Console Communication 
Routine 


Operation: This module enables disabled recovery 
routines to communicate with the system operator 
through the master console (or its alternate) during 
system recovery processing. 

Entry from: TEESTPRS, IEEVEXSN, IGFPXMFA. 
Exit to: Caller. 

IEEVDEV — Device Subroutine 

Operation: This routine obtains information regarding 
the condition of available paths to a device and 


provides that information to the caller. 


Entry from: Allocation, DDR, VAP, VARY CPU, 
VARY PATH, IEEVCPRL. 


Exit to: Caller. 
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JEEVEXSN — Excessive Spin Notification Routine 


Operation: This routine is called by various system spin 
routines to communicate with the operator when an 
excessively long spin is detected. The operator is asked 
if the spin should continue or if an ACR condition for 
the other processor should be simulated. 


Entry from: TEAVELK, IEAVERI, IEEVLDWT, 
IEAVTMTC, and IEAVINV. 


Exit to: Caller. 
IEEVIPL — Master Scheduler Base Initialization 


See OS/VS2 System Initialization Logic for a module 
description of IEEVIPL. 


IEEVJCL — Job Control Language Build Routine 
Operation: This module builds internal JCL text for a 
command task that represents a START, MOUNT, or 
LOGON command. 

Entry from: TEEVSTAR via branch for a START 
command; IEEVMNT1 via branch for a MOUNT 
command; IKJEFLA via branch for a LOGON 
command. 

Exit to: TEESB605 via XCTL. 

IEEVLDWT — Load Wait State Processor 

Operation: This module serves as the interface for 
loading a disabled wait state or restartable wait state. 
For restartable wait states, it spins for the restart 
resource and interfaces with the stop/restart 
subroutine. 

Entry from: TEEMPS03, IECVIRST, and IECVRSTI. 
Exit to: Caller. 

IEEVMESS — Reconfiguration Message Module 


Operation. TEEVMESS performs message processing 
for all the reconfiguration modules. It is called to: 


e Obtain storage for and initialize a message buffer 
e Place a specified message in a given message buffer 


e« Write out the messages in a specified message 
buffer 
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e Issue a specified message as a WTO or WTOR 
e Free message buffer storage 

Called by: Reconfiguration modules. 

Exit to: Caller. 

Error exit: RTM via an ABEND macro. 

Called routines: TEEVTEXT. 


IEEVMNT1 — MOUNT Command Syntax Check 
Routine 


Operation: This module checks a MOUNT command 
and its parameters for correct syntax. It also uses this 
input to build a START descriptor table (SDT) that 
contains internal JCL. 

Entry from: IEEPRWI2 via XCTL. 


Exit to: TEEVJCL via branch for normal processing; 
IEEPRTN2 via XCTL for error processing. 


IEEVMNT2 — MOUNT Command Processor 
Operation: This module checks the unit control block 
(UCB) associated with the device to be mounted. If the 
device is a tape drive marked reserved, EEVMNT2 
issues an error message. Otherwise, it also checks the 
MOUNT command input buffer (CIB) for the use 
attribute specified for the device. 


Entry from: IEFSD263, an initiator routine, via 
ATTACH. 


Exit to: TEFSD263 via branch. 
IEEVMSG — STC Message Module 


Operation: This module contains the text of messages 
issued by the started task control routines. 


Entry from: TEEVMNT2 or IEESB605 via CALL. 
Exit to: Caller via branch. 

IEEVPTH — VARY Path Command Processor 
Operation: This routine makes individual paths to a 


device either available or unavailable for I/O 
processing. 


Entry from: IEEVWAIT. 
Exit to: Caller. 


IEEVSEND -—— Operator SEND Command Main 
Control 


Operation: This module provides a console or 
TSO-terminal operator with a means of communicating 
with other TSO and/or console operators. 

Entry from: TEEVWAIT. 

Exit to: End of task. 

IEEVSND2 — SEND Command Mail Handler 
Operation: This module saves the mail for specified 
users in the mail section of the SYS1.,BRODCAST data 
set. . 7 
Entry from: TEEVSND9. 

Exit to. TEEVSND9. 

IEEVSND3 — SEND Command List Handler 
Operation: This module lists all notices from or recovers 
a specific notice from, the SYS1.BRODCAST data set 
for the sending operator. 

Entry from: TEEVSND9. 

Exit to. TEEVSND9. 

IEEVSND4 — SEND Command Cleanup Routine 


Operation: This module issues informational, warning, 
and error messages to the operator. 


Entry from: TEEVSEND. 
Exit to. TEEVSEND. 
IEEVSND5 — Operator SEND Command I/O Routine 


Operation. This module performs I/O operations for 
the SEND command. 


Entry from: TEEVSND2, IEEVSND3, IEEVSND8, 
IEEVSND39. 


Exit to: Caller. 
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IEEVSND6 — SEND Command Now Processor 


Operation: This module issues the SEND command text 
to the specified recipients. 


Entry from: TEEVSEND. 
Exit to. TEEVSEND. 
IEEVSND8 — SEND Command Notice Handler 


Operation: This module adds notices to or deletes 
notices from the SYS1.BRODCAST data set. 


Entry from: TEEVSND9. 
Exit to: TEEVSND9. 


JIEEVSND9 — SYS1.BRODCAST Data Set Access 
Controller 


Operation: This routine coordinates the operator usage 
of the SYS1.BRODCAST data set. 


Entry from: IEEVSEND. 
Exit to. TEEVSEND. 


IEEVSTAR — START Command Syntax Check 
Routine 


Operation: This module checks a START command and 
its parameters for correct syntax. It uses this input to 
build a START descriptor table (SDT) that contains 
the internal JCL for the task to be started. 

Entry from: IEEPRWI2 via XCTL. 


Exit to. TEEVICL via branch, for normal processing; 
IEEPRTN2 via XCTL, for error processing. 


IEEVSTEE — ESTAE Routine for IEEVSTEL 
Operation: This module performs recovery processing 
for IEEVSTEL. Unless a previous recovery routine has 
already produced diagnostic information, IEEVSTEE 
writes a record in SYS1.LOGREC and issues an 
SDUMP. 

Called by: RTM. 


Exit to: Caller. 
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JEEVSTEL — Vary Storage Element Reconfiguration 
Processor 


Operation: TEEVSTEL varies a storage element on or 
offline in response to a VARY STOR command. 


Called by: TEEVSTOR. 
Exit to: Caller. 
Error exit. RTM via an ABEND macro. 


Called routines: TEEVSTGL, IEEVSTFA, and 
IEEVMESS. 


IEEVSTFA — Find Alternates for Vary Storage Element 


Offline 


Operation: When varying a storage element offline, this 


_ module determines which, if any, R-S pairs in the 


storage element contain MVS preferred data or 
hardware system area. For each R-S pair that does, 
IEEVSTFA selects from another storage element a 
suitable R-S pair into which the data can later be 
swapped. 

Called by: TEEVSTEL. 

Exit to: Caller. 

Error éxit. RTM via an ABEND macro. 

Called routines: TEAVRCF3 and IEEVSTGL. 
IEEVSTGL — Vary Storage Logical Routine 
Operation. TEEVSTGL is called during VARY STOR 
command processing to logically vary a specified 
number of frames on or offline. 

Called by. TEEVSTGP, IEEVSTEL, and IEEVSTFA. 
Exit to: Caller. 

Error exit. RTM via an ABEND macro. 


Called routines. TEAVRCF3, IEEVMESS, and 
IEEVALST. 


IEEVSTGP — Vary Storage Physical Routine 
Operation. TEEVSTGP varies a range or an amount of 


storage on or offline in response to a VARY STOR 
command. 
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Called by. TEEVSTOR. 
Exit to: Caller. 
Error exit. RTM via an ABEND macro. 


Called routines: TEAVRCF3, IEEVMESS, and 
IREVSTGL. 


IEEVSTOP — Vary CPU Stop Routine 


Operation: IEEVSTOP stops the processor on which it 
is running. In order to stop the processor, IEEVSTOP 
ensures that the CSD indicates that the processor is 
offline, resets the processor’s prefix register to zero, 
and issues a SIGP STOP instruction to the processor. 


Entry from: Machine check handler, timer, vary CPU 
offline. 


Exit to: None. 
IEEVSTOR — VARY STOR Command Processor 


Operation: TIEEVSTOR controls VARY STOR 
command processing. It: 


e Determines if the command is valid and has been 
issued from an authorized source 


e Routes control to the proper routine to perform the 
reconfiguration 


e Issues the appropriate reconfiguration message(s) 
after the storage has been varied 


Called by: The master scheduler (IEEVWAIT) via an 
ATTACH macro after the operator issues a VARY 
STOR command. 


Exit to: Caller. 
Error exit. RT via an ABEND macro. 


Called routines. TEEMPVST, IEEVMESS, IEEVSTEL, 
and IEEVSTGP. 


IEEVSTPE — ESTAE Routine for IEEVSTGP 


Operation: TEEVSTPE performs recovery processing 
for IEEVSTGP. Unless diagnostic information has 
already been produced, IEEVSTPE writes a record in 
SYS1.LOGREC and issues an SDUMP. It also issues a 
message telling the operator what happened before the 
error occurred. In some cases, it backs out of 
processing done prior to the error. 


Called by. RTM. 
Exit to: Caller. 


Called routines: TEAVRCF3, IEEVMESS, and 
IEEVSTGL. 


IEEVSTRE — ESTAE Routine for IEEVSTOR 


Operation: IEEVSTRE performs recovery processing 
for IEEVSTOR. It records the diagnostic information 
in SYS1.LOGREC, issues an SVC dump, and issues 
message [EE713I. 


Called by: RTM. 

Exit to: Caller. 

Called routines: TEEVMESS. 
IEEVWAIT — Master Scheduler Wait 
In the Master Scheduler Address Space 


Operation: At system initialization time, IEEVWAIT 
terminates system trace (if necessary), and attaches the 
system log task. After system initialization, 
IEEVWAIT’s main function is to scan the CSCB chain 
and process the pending commands that execute in the 
master scheduler address space. If invoked for a 
START command, IEEVWAIT posts ECB CHASWT 
to notify the caller when master scheduler initialization 
is complete. 


Entry from: TEEMB860 at system initialization time; 
IEE0803D via POST. 


Exit to. No normal exit. This is a permanent task. 


Error entry. At entry point STAE0000 from failure or 
from ABEND. 


Error exit: To a wait state if restart fails. 

In the Communications Task Address Space 

Operation: During system initialization, IEEVWAIT 
performs no major function in the communications task 
address space. After system initialization, 


IEEVWAIT’s only function in the communications task 
address space is to scan the CSCB chain and process 
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the pending commands that execute in this address 
space. 


Entry from: IEAVN701 during system initialization, 
IEEO803D via POST. | 


Exit to. No normal exit. This is a permanent task. 


Error entry: At entry point STAE0000 from failure or 
from ABEND. 


Error exit: To the dispatcher. 


IEEVWKUP — Vary CPU Wakeup and Quiet 
Routine(s) 


Operation: This routine performs one of three 
functions: 


e« It completes the preliminary initialization for the 
processor that is being brought online. 


e It performs a quiesce function for the vary offline 
process. This includes resetting control registers to 
their initial values. 


e It initializes the channel availability table in the 
physical configuration communication area of the 
executing processor. 7 


Entry from: TEEVCPRL. 


Exit to: Dispatcher (when varying a processor online), 
IEEVSTOP (when varying a processor offline). 


IEEXEDNA — Display Consoles Command Processor 


Operation: This module writes a console status display 
to the console that issued the command. 


For input stream commands, the display goes to the 
master console. If L=cca is specified, output goes to 
the routed console, which may be different from the 
one issuing the command. 

Entry from: TEEVWAITT. 

Exit to: Dispatcher or end of task. 


IEE0003D — ESTAE Environment Creation Routine 


Operation: This routine creates an ESTAE environment 


routine to protect the command scheduler from 
ABEND situations. 
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Entry from: Issuer of SVC 34. 
Exit to: TEEO303D. 
IEE00110 — Master Scheduler SVC 110 Router 


Operation: This module routes control for the 
processing of the commands D C,K; D U; and D PFK. 


Entry from: TEEPALTR. 
\. 
Exit to: TEE10110, IEE20110, IEE40110. 


IEE0303D — Control Block Chain Manipulator; 
QEDIT and MGCR Macro Function Processor 


Operation: This module manipulates chains. It also 
communicates ABTERM requests to the ABTERM 
routines, and it is the QEDIT processor. 

Entry from: TEEOO03D. 

Exit to: TEES403D. 

IEE0403D — Command Scheduler Router 
Operation: This module scans, identifies, and verifies 
commands. It gives control to the proper command 
processor. - 

Entry from: IEE5403D. 

Exit to: TEEQ503D, command processors. 
IEE0503D — Command Processing Message Assembly 
Operation: This module assembles and edits messages 
for command processors. It issues WTO or TPUT 
macros to write the messages. 

Entry from: Command processors. 

Exit to: The address passed by the caller. 

IEE0603D — Immediate Routine for SET Command 
Operation: This module inspects the operands of the 
SET command and routes control to the appropriate 
processing module. 


Entry from: TEEO403D. 


Exit to. TEE6503D, IEE6603D, IEE0803D, IEE0503D. 
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IEE0703D — MODIFY and STOP Command 
Processor 


Operation: This module performs processing for the 
STOP and MODIFY commands. 

Entry from: TEEO403D. 

Exit to: TEEQ003D. 

IEE0803D — CSCB and ASCB Creation 

Operation: For task-creating commands, this module 
builds a CSCB. For address space-creating commands, 
this module interfaces with address space-requesting 
routines. 

Entry from: Variable. 

Exit to: TEEO003D, to post IEEVWAIT. 

TEE10110 — Display C, K Processor 

Operation: This module writes a status display showing 
the CONTROL (K) command operands using a 
multiple-line WTO macro. 

Entry from: IEEQ0110 via CALL. 

Exit to: TEE00110. 


IEE1403D — HALT, SWITCH, and TRACE Command 
Syntax Checker 


Operation: This module preprocesses the HALT, 
SWITCH, and TRACE commands by checking the 
command syntax. 

Entry from: TEE0403D. 

Exit to: TEEQ803D, IED1303D, ISTCFF3D. 


JIEE1603D — LOG and WRITELOG Command 
Processor 


Operation: This module processes the commands LOG 
and WRITELOG (with the options CLOSE, START, 
or CLASS). 

Entry from: IEEO403D. 


Exit to: TEEO003D. 


IEE20110 — Display Unit Processor —— Unit Status, 
One 


Operation: This module analyzes the operands of a D U 
command, gets a work area, and finds the first UCB for 
the first unit to be displayed. 

Entry from: TEEO0110. 

Exit to: TEE23110, T1EE22110. 


IEE21110 — Display Unit Processor — Unit Status, 
Two 


Operation: This module loads the device name table the 
first time it is needed and creates the text of each line 
to be displayed. 

Entry from: TEE23110. 

Exit to: TEE23110. 


JTEE22110 — Display Unit Processor — Unit Status, 
Three 


Operation: This module issues error messages, frees 
work area storage, and deletes the device name table. 


Entry from: TEE20110, IEE23110, IEE24110. | 
Exit to: End of task. 
IEE2303D — SMF VARY Record Handler 


Operation: This module writes an SMF VARY 
ONLINE record. 


Entry from: TEE3303D. 
Exit to. TEE4203D, IEE4403D. 


JEE23110 — Display Unit Processor — Unit Status, 
Four 


Operation: This module determines the next unit 
address to be displayed and issues the WTO for the 
lines of the display. 

Entry from: TEE20110. 

Exit to: TEE21110, TIEE22110. 


Called routines: TEE21110, IEE24110. 
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IEE24110 — D U,,ALLOC Command Processor 


Operation: This module gathers and displays the 
information requested on the D U,,ALLOC command. 
The information displayed consists of the jobname and 
ASID of the job(s), started task(s), or TSO user(s) to 
which a unit is allocated. 

Entry from: TEE23110. 

Exit to: TEE22110, TEE23110. 

Called routines: TEECB801. 

JEE3103D — VARY ONLINE/OFFLINE Processor 


Operation: This module varies non-console units to 
either an online or an offline status. 


Entry from: TEE4203D, IEE4603D. 

Exit to: End of task, TEECB904. 

Called routines: TEFENFFX. 

IEE3203D -——- VARY Keyword Scan 

Operation: This module scans first the primary 
keywords then the secondary keywords of the VARY 
command. It passes control according to the keyword 
found. 

Entry from: TEEQ403D. 


Exit to: Variable. 


IEE3303D — VARY ONLINE/OFFLINE/CONSOLE 
Syntax Scan 


Operation: This module checks the unit field syntax, 
command authority, and presence of SMF in order to 
route control to the appropriate processor. 


Entry from: TEE3603D. 


Exit to: TEE4403D, IEE4203D, TEE2303D, 
TEECB904. 


IEE3503D — DISPLAY/TRACK Router 
Operation: This module routes control to a processor 


module based on the command operand. It processes 
the D T command itself. 
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Entry from: TEEQ403D. 

Exit to: Variable. 

IEE3603D — VARY Command Pre-processor 
Operation: This module presets the environment for the 
VARY ONLINE/OFFLINE/CONSOLE commands. 
It also keeps offline all devices without available paths. 
Entry from: TEEVWAIT, IEECB904. 

Exit to: TEE3303D. 

IEE3703D — CANCEL/FORCE Command Handler 
Operation: This module cancels or forces any 
background and foreground (TSO) jobs that are 
currently executing. 

Entry from: TEE0403D. 

Exit to: TEEO003D. 

TEE40110 — Display PFK Processor 

Operation: This module locates and displays the 
program function key definitions currently in effect for 
the operator’s display console. 

Entry from: TEE00110. 

Exit to: Caller. 


TEE4103D — Hard Copy Informational Message 
Module 


Operation: This module issues a hard copy information 
message for devices that have been varied as a hard 
copy device. 

Entry from. TEE7203D. 

Exit to: TEEO003D. 

IEE4203D — UCME Scanner for VARY Command 


Operation: This module does syntax validation for 
VARY ONLINE/OFFLINE/CONSOLE commands. 


Entry from: TEE4403D, IEE3303D, IEE2303D. 


Exit to. TEE4903D, [EE3103D, IEE4603D, 
TEECB904. 
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IEE4303D — Processor for VARY Master Console 
Command 


Operation: This module processes the VARY 
MSTCON. 

Entry from: TEE3203D. 

Exit to: TEEQ003D. 

IEE4403D — VARY Keyword Scanner 


Operation: This module scans the input buffer and 
validates keyword values. 


Entry from: 1EE3303D, IEE2303D. 
Exit to: TEE4203D. 


IEE4603D — VARY ONLINE/OFFLINE for Console 
Devices 


Operation: TSis module processes the VARY command 
keywords ONLINE and OFFLINE. 


Entry from: TEE4203D. 
Exit to: TEE3103D, IEECB904, SVC 3 (IGCO0Q3). 
IEE4703D — VARY HARDCPY Operand Processor 


Operation: This module begins the processing of a 
VARY HARDCPY Command. 


Entry from. TEE3203D. 
Exit to: TEES703D, IEE7203D. 
IEE4803D — Console Information Message Routine 


Operation: This module uses the UCM and UCB to 
construct a console status message. 


Entry from: TEE4903D. 
Exit to. TEE7303D. 
IEE4903D — Console Operand Processor 


Operation: This module processes the CONSOLE 
Operand for the VARY command. 


Entry from: TEE4203D. 


Exit to. TEE4803D. 

IEES103D — ESTAE Exit Routine 

Operation: This module is the SVC 34 ESTAE exit 
routine. It provides a storage dump in response to an 
ABEND situation, and it checks the oe of entries 
in the CSCB and CIB chains. 

Entry from: ABEND STAE interface routine. 

Exit to: Termination retry address in parameter list. 
IEES403D — Command Translation Routine 
Operation. This module translates lower case letters, 
initializes the XSA, finds the beginning of a command 
verb and writes the command to hard copy if required. 
Entry from: IEEO303D. 

Exit to: TEEO403D. 

IEES503D — Stop Track and Stop Monitor Processor 


Operation: This module processes the operands for both 
the STOPTR and STOPMN commands. 


Entry from: 1EE7503D, IEE0403D. 
Exit to: IEE6703D, IEE0003D, IEE7103D, IEE0503D. 


IEES603D — MSGRT and CONTROL Command 
Message Module 


Operation: This module issues error messages for 
CONTROL and MSGRT commands and for L=cca 
operands. 

Entry from: Variable. 

Exit to: TEE5903D, IEE0503D, or system. 
IEES703D — VARY HARDCPY, OFF Processor 


Operation: This module removes the hardcopy function 
from a system when requested. 


Entry from: IEE4703D. 


Exit to: TEEQOO3D. 
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IEES903D — Error Message Module 2 for CONTROL 
and MSGRT Commands 


Operation: This module handles the second parts of 
messages for the appropriate commands and also for 
the L=cca operand errors. 

Entry from: TEES603D. 

Exit to: TEEQ003D. 

IEE6303D — MSGRT Command Handler I 
Operation: This module builds the route control table 
(RCT) for each console. This table provides default 
routing values. 

Entry from. TEEO403D. 

Exit to: TEE0503D, IEE6403D. 

IEE6403D — MSGRT Command Handler II 


Operation: This module formats a MSGRT command 
on the basis of values in the route control table. 


Entry from: TEE6303D. 

Exit to: TEEO003D, IEE5603D. 

TEE6503D — Set Local Time 

Operation. This module changes or resets the local time 
and date. It also updates the real time timer queue 
element (TQE) queue. 

Entry from. TEE0Q603D. 

Exit to. TEEQ603D. 

IEE6603D — Set Time-of-Day Clock Routine 


Operation: This module sets a TOD clock with a time 
and date value that has been specified by an operator. 


Entry from: TIEE0603D. 
Exit to: Caller. 


IEE6703D — Processor for CONTROL and STOPTR 
Commands | 


Operation: This module handles the syntax checking of 


the K command and schedules the STOPTR command 
and the K command. 
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Entry from: TEE7503D. 
Exit to: Variable. 
IEE6803D — K A,nn,nn Command Handler 


Operation: This module handles the processing of the K 
A command, which defines CRT screen areas. 


Entry from: 1EE6703D. 
Exit to: TEEQ003D, IEE5603D. 


IEE6903D — K A, K T, and K M,REF Command 
Handler 


Operation: This module handles K T, K A, K A,NONE, 
K M, and K M,REF commands. 


Entry from: TEE6703D. 
Exit to: TEEQ003D, IEE5603D. 


IEE70110 — Halt-End-of-Day and Switch-SMF 
Processor 


Operation: This module processes HALT EOD and 
SWITCH SMF commands. 


Entry from: Attached by IEEVWAIT. 
Exit to: Caller. 


Called routines: TEE90110 via BALR, IEECB860 
(ESTAE), and IEEMB803 log task via POST. 


IEE7103D — MONITOR Command Processor 


Operation: This module processes the MONITOR 
command operands. 


Entry from: TEE0403D. 

Exit to: TEEQ003D, IEE0503D. 

IEE7203D — VARY HARDCPY Processor II 
Operation: This module changes the hard copy 
configuration in a multiple console support (MCS) 
environment. 


Entry from: TEE4703D. 


Exit to: TEE4103D. 
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IEE7303D — Console Information Message Routine 2 


Operation: This module constructs a message that 
displays the current status of a console. 


Entry from: TEE4803D. 

Exit to: End of task. 

IEE7503D — Routing and List Operand Processor 
Operation. This module processes the routing operands 
for DISPLAY, TRACK, CONTROL, and STOPTR 
commands. It also syntax checks the secondary 
operands (LIST, ALL, and name) for the DISPLAY 
and TRACK commands. 

Entry from: TEE3503D, IEE0403D, JES2 routine. 


Exit to. TEE0803D, IEE5503D, IEE6703D, IEE5603D, 
IEE0503D, TIEE9403D, JES2 routine. 


IEE7703D — CONTROL-V Command Handler 


Operation: This module processes CONTROL V 
commands. 


Entry from. TEE6703D. 
Exit to: TEEQ003D, TEE5603D. 
IEE7803D — CONTROL C,D Command Handler 


Operation: This module processes the CONTROL C,D 
command for cancelling an inline MLWTO. 


Entry from: TEE6703D. 

Exit to: TEEQ003D, IEE5603D. 

IEE7903D — CONTROL M Command Handler 
Operation: This module processes CONTROL M 
commands for activating or deactivating the action 
message retention facility and changing the WQE 
buffer limits. 

Entry from: TEE6703D. 

Exit to: TEEOS03D, IEES603D. 

IEE8B03D — CONTROL Q Command Processor 


Operation: This module processes the CONTROL Q 
command for re-routing messages. 


Entry from: TEE6703D. 

Exit to: TEE0003D. 

IEE8103D — CONTROL C,A/E/I Command Handler 
Operation: This module deletes retained action 
messages in response to a CONTROL C,A, | 
CONTROL C,E, or CONTROL C,I command. 

Entry from: TEE6703D. 

Exit to: TEES603D. 

Called routines: TEAVQ700. 

IEE8603D — SETDMN Command Processor 


Operation. This module passes new domain description 
values to the system resources manager (SRM). 


Entry from: TEEQ403D. 

Exit to: TEEQ003D. 

IEE90110 — HALT/SWITCH Message Module 
Operation: This module assembles and edits messages 
for HALT and SWITCH commands, and issues a 
WTO. 

Entry from: TEE70110. 

Exit to: TEE70110. 

IEE9403D — MSS Preprocessor 

Operation. If MSS is active this module prepares MSS 
commands for interfacing to MSS routines, then posts 


the MSS routines. 


Entry from: TEE0403D, IEE1403D, IEE3203D, 
TRE7503D. 


Exit to: Caller. 

IEFAB4A0 — Common Unallocation Control 
Operation: This module controls the processing 
necessary to unallocate a request that has been 
allocated by means of either JCL or a dynamic 


allocation. The functions provided are: 


e Disposition processing 
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Disconnecting of private catalogs 
Data set release (DEQ) 

Unit unallocation 

Volume release (DEQ) 

Release of DSAB/TIOT entries 


oo # ® @ e 


Entry from. TEFAB4DE, IEFAB477, IEFAB490, 
TEFAB492, IEFBB414, IEFBB416, IEFDB4A1, 
TEFDB413, IEFDB418. 


Exit to: Caller. 


Called routines: TEEAB401, IEFAB4A2, IEFAB4A4, 
TEFAB4A6, IEFAB4A8, IEFAB4FC, IEFAB4F4. 


IEFAB4A2 — Disposition Processing Control 

Operation: This module controls the processing required 
to dispose of data sets as indicated in the input 
requests. 

Entry from: TEFAB4A0. 

Exit to: Caller. 


Called routines: TEFAB4A3, IEFAB4B0, IEFAB4B2, 
IEFAB4SF. 


IEFAB4A3 — Special Scratch/Catalog Processing 


Operation: This module builds a dummy ETIOT needed 
by the scratch function of data management, when no 
DSABs and TIOTs exist. 


This module also interfaces with IEFAB4F' to allocate 
and open step catalogs, if requested, and with 
IEFAB4F4 to unallocate all private catalogs when the 
disposition processing has completed, if the allocation 
of step catalogs was requested. 


Entry from: TEFAB4A2. 
Exit to: Caller. 


Called routines: TEFAB4FC, IEFAB428, IEFAB4F4, 
TRFAB4F5. 


IEFAB4A4 — Unit Unallocation Control 

Operation: This module controls the processing 
associated with unallocating devices for each request. 
The functions performed are: 

e Releasing units no longer needed 


e Rewinding tape volumes 
e Deleting outstanding mount messages 
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e Posting waiting allocations 
Entry from: TEFAB4A0, IEFAB4DE. 
Exit to: Caller. 


Called routines: TEFAB4FA, IEFAB4F7, IEFAB493, 
TEFHB410. 


IEFAB4A6 — Data Set Release 


Operation: This module releases (dequeues) data sets 
that are no longer needed by the job. 


Entry from: TEFAB4A0, IEFBB401. 

Exit to: Caller. 

Called routines: TEFAB4F7. 

IEFAB4A8 — Volume Release 

Operation: This module is responsible for releasing 
volumes that were reserved for the job step by 
allocation and data management 
(OPEN/CLOSE/EOV). 

Entry from: TEFAB4A0. 

Exit to: Caller. 

Called routines: None. 

IEFAB4B0 — Disposition Message Routine 


Operation: This module issues disposition messages to 
the system output data set and to the system operator. 


Entry from. TEFAB4A2. 

Exit to: Caller. 

Called routines: TEFAB4FD. 

IEFAB4B2 — Alternate Disposition Message Routine 
Operation: This module issues disposition messages to 
the system output data set and/or to the system 
operator when no storage is available for a volume list. 


Entry from: IEFAB4A2. 


Exit to: Caller. 
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Called routines: TEFAB4FD. 
IEFAB4DC — Data Set Reservation/ Release 


Operation: This module can perform the following 
functions: 


e Updates the data set enqueue table to add or 
change an entry 


e Dequeues the dsname 


e Updates the data set enqueue table to delete an 
entry 


Entry from: TEFAB459, TEFDB411, IEFDB413, 
TEFDB418. 


Exit to: Caller. 
Called routines: TEFAB4F7. 
IEFAB4DD — Job/Step Unallocation ESTAE Exit 


Operation: In the event of an abnormal termination, this 
module calls step and/or job unallocation, if needed, 
and if SWA records have been read successfully. This 
module also requests a dump, if necessary. 


Entry from: RTM (recovery termination management). 
Exit to: Caller. 


Called routines: TEEAB400, IEEAB401, IEFBB414, 
TEFBB416. 


IEFAB4DE — Common Unallocation ESTAE Exit 
Routine 


Operation: If an abnormal termination occurs in a 
module that had requested a retry, IEFAB4DE puts the 
address of the allocation ESTAE retry block (AERB) 
into the SDWACOMU field of the SDWA and returns 
to the caller. Otherwise, this module attempts to 
perform any common unallocation functions that had 
been requested but not yet attempted at the time of an 
abnormal termination. 


Entry from: IEFAB4ED. 
Exit to: Caller. 


Called routines: TEFAB4A0, TEFAB4A4, IEFAB4FA. 


IEFAB4EA — Housekeeping ESTAE Exit Routine 


Operation. This module reestablishes control block 
pointers and frees resources for JFCB housekeeping 
control (IEFAB451), allocate catalog control 
(IEFAB4F5S), or unallocate catalog control 
(TIEFAB4F4), if an ESTAE is scheduled in any of those 
routines as the result of an ABEND. 


Entry from: TEFAB4ED. 

Exit to: Caller. 

Called routines: IEFAB4F4. 

IEFAB4EB — PDI Read and Chain 

Operation: This module reads all the PDIBs (passed 
data set information blocks) that comprise the PDI 
(passed data set information) and chains the PDIBs 
together. 

Entry from. TEFAB455, IEFAB459, IEFBB416. 
Exit to: Caller. 

Called routines: TEFAB4F7. 

IEFAB4EC — Group Lock/Unlock Interface 
Operation: This module obtains locks for the groups 
represented by the list of UCBs passed to it. It 
performs this serialization via the allocation queue 
manager. 

Entry from: TEFBB416. 

Exit to: Caller. 

Called routines: TEFAB4FA, IEFAB4UV. 
IEFAB4ED — Allocation Common ESTAE Exit 
Operation: This module is the common ESTAE exit for 
all of allocation. It performs general recovery 
processing and then routes control to other exit 
routines for more specific recovery. If a specific 
recovery routine requests a retry, this module returns to 
RTM requesting a retry. Otherwise, after all of the 
recovery routines have completed processing, this 
module returns to RTM requesting percolation. 


Entry from: RTM (recovery termination management). 


Exit to: Caller. 
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Called routines: TEEAB401, IEFAB4DD, IEFAB4DE, 
IEFAB4EA, IEFAB4E2, IEFAB4E4, IEFAB4E7, 
IEFAB4E8, IEFDB402. 

IEFAB4EE — Allocation Message Routine 


Operation: This module builds the allocation messages 
for the requests on the input SIOT chain. 


Entry from: TEFAB490, IEFBB414. 

Exit to: Caller. 

Called routines: TEFAB4FD, IEFAB4F3. 

IEFAB4EF — PCCB Routine 

Operation. This module handles all requests for the 
creation, modification, and deletion of PCCB(s) and 
their chain structure. 

Entry from: TEFAB4F4, IEFAB4F5, IEFAB452. 
Exit to: Caller. 

Called routines: None. 


IEFAB4EG —— Allocation Resource Manager ESTAE 
Exit Routine 


Operation: If the allocation resource manager 
(IEFAB4F5) abnormally terminates and had requested 
a retry, IEFAB4EG puts the address of the allocation 
ESTAE retry block (AERB) into the SDWACOMU 
field of the SDWA. 

Entry from. TEFAB4ED. 

Exit to: Caller. 

Called routines: None. 

IEFAB4E0 — Test If Device Is Ready 

Operation: This module tests to determine whether a 
device is physically ready by issuing a NOP EXCP to 


the device. 


Entry from: EFAB473, IEFAB49C, IRFAB494, 
IEFAB495. | 


Exit to: Caller. 


Called routines: None. 
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IEFAB4E1 — VM&V FRR Exit Routine 

Operation: This module receives control if an ABEND 
occurred while an MVCA was being dechained. It tries 
again to take the MVCA off the chain. If successful, it 
sets a bit to indicate that it should free MVCA storage. 
Entry from: RTM (recovery termination management). 
Exit to: Caller. 

Called routines: None. 

JEFAB4EZ2 — VM&V ESTAE Exit Routine 

Operation: If an abnormal termination occurs in a 
module that had requested a retry, IEFAB4E2 puts the 
address of the allocation ESTAE retry block (AERB) 
into the SDWACOMU field of the SDWA and returns 
to the caller. Otherwise, this module releases mount 
control blocks that still exist for this allocation. 

Entry from: IEFAB4ED. 

Exit to: Caller. 

Called routines: TEFAB49A, IEFAB498. 

IEFAB4E3 — Job/Step Allocation Retry Routine 
Operation: This retry routine receives the initiator’s 
registers on entry. It sets a return code of 4 and 
branches on register 14, thereby simulating an error 
return to the initiator. 

Entry from: RTM (recovery termination management). 
Exit to: TEFSD162. 

Called routines: None. 

TEFAB4E4 — Job/Step Allocation ESTAE Exit 
Operation: This module sets bits in the LCT to indicate 
that an error has occurred. It then prepares for retry by 
storing the initiator’s registers in the SDWA. These 
registers will be received by retry routine IEFAB4E3. 
Entry from: TEFAB4ED. 

Exit to: Caller. 


Called routines. TEEAB400, IEEAB401, IRFAB4F7. 
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IEFAB4E5 — Allocation Resource Manager 


Operation: This module attempts to clean up system 
resources owned by allocation in the event of an 
abnormal memory termination. It does the following: 


e Releases device groups held by the terminating 
address space 


e Frees cross memory communication areas 

e Posts other allocations waiting for devices 

e Unallocates UCBs allocated to this address space 
Entry from: RTM (recovery termination management). 
Exit to: Caller. 

Called routines. TEFAB4FA, IEFAB498, IEFHB410. 
TEFAB4E6 — Allocation Recovery Routine 

Operation. This module handles abnormal terminations 
that occur when the allocation address space is being 
initialized or updated or when the UCB field 
UCBUSER is being updated. It also checks the counts 
in the UCB and DALT to ensure that they are correct. 
Entry from: RTM. 

Exit to: Caller. 


Called routines: TEFHB410 by means of a program call 
(PC). 


IEFAB4E7 — Group Lock/Unlock ESTAE Exit 


Operation: This module frees resources held by 
LOCK/UNLOCK processing (IEFAB4EC) if an 


ABEND occurs while IEFAB4EC’s ESTAE is in effect. 


Entry from: TEFAB4ED. 

Exit to: Caller. 

Called routines: IEFAB4FA. 

IEFAB4E8 — Common Allocation ESTAE Exit Routine 
Operation: If an abnormal termination occurs in a 


module that had requested a retry, IEFAB4E8 puts the 
address of the allocation ESTAE retry block (AERB) 


into the SDWACOMU field of the SDWA and returns 
to the caller. Otherwise, this module performs cleanup 
processing if an abnormal termination has occurred 
during common allocation processing. 


Entry from: TEFAB4ED. 
Exit to: Caller. 


Called routines: TEEAB401, IEFAB4FA, IEFAB49A, 
TEFAB498. 


IEFAB4E9 — Dynamic Allocation Set DSABDCBM 
Mask Bits Subroutine 


Operation: For each filled-in DCB field in the JFCB, 
this module sets on the corresponding bit in 
DSABDCBM. 


Entry from: TEFAB428, TIEFDB411. 

Exit to: Caller. 

Called routines: None. 

IEFAB4FA — Allocation Queue Manager 


Operation: This module serializes access to UCB 
(device) groups by device allocation and manages the 
WAIT-FOR-DEVICE queue. 


Entry from. EFAB4A4, IEFAB4DE, IEFAB4ES, 
IEFAB4E8, IEFAB471, IEFAB472, IEFAB485, 
IEFAB486, IEFAB490, IEFAB491, IEFAB492. 


Exit to: Caller. 
Called routines: TEAOPTO1 (system post). 
IEFAB4FC — TIOT Manager Control Routine 


Operation: This module is responsible for obtaining and 
maintaining the TIOT and the DSAB queue descriptor 
block (QDB). The functions of this routine are: 


Create the TIOT and DSAB QDB 

Initialize TIOT and DSAB QDB. 

Allocate a TIOT DD entry 

Release a TIOT DD entry 

Update the TIOT and DSAB QDB 
Unallocate the DSAB/TIOT(ETIOT) entry 
Concatenate the DSAB/TIOT DD entry 
Free the TIOT and QDB 
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Entry from: TEESB601, IEFAB4A0, IEFAB4A3, 
IEFAB428, IEFBB401, IEFBB404, IEFBB410, 
TEFDB413, IEFDB450. 

Exit to: Caller. 

Called routines: None. 

IEFAB4FD — System Message Interface Routine 
Operation. This module converts the input parameter 
list into a WTO parameter list, which it passes to 
IEEAB400. IEEAB400 buffers any WTO messages 
(routing code 11) and issues the WTO macro 
instruction if any other routing codes are specified. 
Entry from: TEFAB4B0, IEFAB4B2, IEFAB4EE, 
IEFAB490, IEFBB401, IEFBB402, IEFBB404, 
IEFBB410. 

Exit to: Caller. 

Called routines: TEEAB400. 

IEFAB4FE — SWA Reader Routine 


Operation: This module establishes addressability to 
SIOTs and their related JFCBs and JFCBXs. 


Entry from: TEFBB401, IEFBB410, IEFDB400. 
Exit to: Caller. 
Called routines: TEFAB4F7. 


IEFAB4F0 — Generalized Conditional ENQ/DEQ 
Routine 


Operation: This module does the following: 


e Enqueues conditionally (either shared or exclusive) 
on the input volume serial number 


¢ Dequeues conditionally on the input volume serial 
number 


Entry from: TEFAB436, IEFAB497, IEFAB492. 
Exit to: Caller. 


Called routines: None. 
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IEFAB4F1 — Test Volume ENQ 

Operation: This module determines if the input volume 
serial number can be shared by this allocation (even 
though it is already being used by this job step through 
a prior entry to allocation). 

Entry from: TEFAB421. 

Exit fo: Caller. 

Called routines: None. 

IEFAB4F2 — Update Algorithm Tables 

Operation: This module helps maintain the 
cover/reduce algorithm interface tables. Its functions 


are: 


e Change a request to device-required. 
e Indicate a request was just allocated. 


Entry from: TEFAB432, IEFAB434, IEFAB442. 
Exit to: Caller. 

Called routines. TEFAB481. 

IEFAB4F3 — Message Compression Routine 
Operation: This module eliminates consecutive and 
trailing blanks from the text received in the input 
buffer. The compressed text and the new text length 
are returned to the caller. 

Entry from: TEFAB4EE, TIEFAB421, IEFAB48A, 
IEFAB487, IEFAB488, IEFAB490, IEFBB401, 
IEFBB404, IEFBB410. 

Exit to: Caller. 

Called routines: None. 

IEFAB4F4 — Catalog Unallocation Control 


Operation: This module calls other routines to perform 
the following functions, as requested by the caller: 


e Close private catalogs 
e Unallocate private catalogs 
¢« Release private catalog control blocks (PCCBs) 


Entry from. TEFAB4A0, IEFAB4EA, IEFAB4F5, 
TEFAB451. 
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Exit to: Caller. 


Called routines: IDACAT12, IEFAB4EF, IEFDB400 
(via SVC99). | 


IEFAB4F5 — Allocate Catalog Control 
Operation: This module can: 


e Allocate a catalog. 

e Cause an ACB to be created and opened. 

e Cause a PCCB to be created and chained or 
modified. 


Entry from: IEFAB469, IEFICATL (an initiator 
module), IGGOCLCA (a catalog management module), 
IGGOCLC9 (a catalog management module). 


Exit to: Caller. 


Called routines. TIDACAT11, TEFAB4EA, TEFAB4EF, 
TEFAB4F4. 


IEFAB4F6 — GSPACE/FSPACE Service Routines 


Operation. This module obtains storage and subdivides 
them as storage requests are made. Requests for 
release of the 4K blocks and the obtained sections of 
them are also serviced. 


Entry from: Most allocation/unallocation modules, that 
is, modules with names beginning with IEFAB, IEFBB, 
or IEFDB. 


Exit to: Caller. 
Called reutines: None. 
IEFAB4F7 — SWA Manager Interface 


Operation: This module invokes the SWA Manager to 
assign, read, write, or delete blocks of the Scheduler 
Work Area and returns the necessary parameters to the 
caller. 


Entry from: TEFAB4A4, IEFAB4A6, TIEFAB4DC, 
TEFAB4EB, IEFAB4FE, IEFAB4SF, IEFAB427, 
TEFAB452, IEFAB453, IEFAB455, IEFAB457, 
IEFAB458, IEFAB459, IEFAB461, IEFAB464, 
TEFAB466, IEFBB401, IEFBB402, IEFBB410, 
TEFBB416, IEFDB4A1, IEFDB400, IEFDB410, 
TEFDB413, IEFDB414, IEFDB418, IEFDB450. 


Exit to: Caller. 
Called routines: None. 
IEFAB4F8 — Direct Access Label Read 


Operation: This module reads direct access volume 
labels. 


Entry from: TEFAB473, IEFAB49B. 

Exit to: Caller. 

Called routines: None. 

IEFAB4F9 — Tape Label Read 

Operation: This module reads tape volume labels. 
Entry from: TEFAB473. 

Exit to: Caller. 

Called routines: None. 

IEFAB4GB — Modify Device Online/Offline Status 
Operation: This module designates the device status in 
the UCB as either offline or pending offline, depending 


on the input function code. 


Entry from: [EFAB429, IECVRDIO, IECVRSTI, 
IECVFDEV, IECVRRSV. 


Exit to: Caller. 

Called routines: None. 

IEFAB4M4 — Volume Mount & Verify Messages 
Operation: This module contains the text used to 
construct the messages issued by volume mount and 
verify routines. | 
Entry from. Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


Module Descriptions 11-91 


IEFAB4MS5 — WTO Message Module For AVR and 
Common Allocation 


Operation: This module contains the list forms of WTO 
and WTOR messages issued by common allocaticn, 
automatic volume recognition (AVR), and data set 
reservation/release. 

Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines. Not applicable (non-executable 
module). 


IEFAB4M6 — Disposition Messages 

Operation: This module contains the text used to 
construct the disposition messages issued by common 
unallocation. 

Entry from: Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFAB4M7 — Allocation Messages 

Operation: This module contains the allocation 
messages that are issued to the system output data set 
and, for unit record devices, to the console. 

Entry from: Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFAB4M9 — Recovery Allocation Messages 


Operation. This module contains the text used to 
construct recovery allocation operator messages. 


Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 
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IEFAB4SF — Spool File Allocation 


Operation: This module interfaces with the job entry 
subsystem to allocate or unallocate SYSIN and 
SYSOUT data sets. It is also called to segment a 
SYSOUT data set. 


Entry from: TEFAB4A2, IEFAB427, SETPRT SVC. 
Called routines. TEFAB4F7, subsystems. 
IEFAB4UV — Unit Verification 


Operation: This routine is invoked by system routines 
that require information or validity checks based on the 
contents of the eligible devices table (EDT). 


Entry from. IAPINMD, ICBME. 

Exit to: Caller. 

Called routines: None. 

IEFAB421 — Common Allocation Control 


Operation: This module is called to allocate one or more 
data set requests. It is responsible for controlling the 
following functions: 


Process pending offlines/unloads 
Initialize work area (ALCWA) 
Allocate DUMMY requests 
Allocate VIO requests 

Allocate subsystem requests 
Determine device requirements 
Allocate to fixed DA devices 
Allocate TP requests 

Volume reservation 

Allocate by device type 
Recovery allocation 

Dequeue from allocation resource 
Cleanup processing 


Entry from: IEFAB490, IEFBB404, IEFDB413. 
Exit to: Caller. 


Called routines: TEEAB401, IEFAB4F3, IEFAB422, 
TEFAB423, IEFAB425, IEFAB427, IEFAB428, 
IEFAB429, IEFAB430, IEFAB431, IEFAB471, 
TEFAB485, IEFAB490, IEFAB491. 


Licensed Material — Property of IBM 


IEFAB422 — JES3 Interface 

Operation: This module interfaces with the JES3 
subsystem and then updates allocation tables based on 
whether or not JES3 has made device selections. 

Entry from: TEFAB421. 

Exit to: Caller. 

Called routines: None. 

IEFAB423 — Determine Device Requirements 
Operation: The function of this module is to determine 
device eligibility for each individual request and for the 
step. Device requirements are represented by the | 
volunit table and device eligibility is represented by the 
eligible device table (EDT) and eligible device list 
(EDL). This module builds the volunit table and calls 
IEFAB424 to build the EDL. 

Entry from: TEFAB421. 

Exit to: Caller. 

Called routines: TEFAB424, IEFAB426. 

IEFAB424 — Build Eligible Device List (EDL) 


Operation. This module is responsible for construction 
of an eligible device list (EDL) for each request. 


Entry from: TEFAB423. 

Exit to: Caller. 

Called routines: TEFAB438. 
IEFAB425 — Process TP Requests 


Operation: This module controls the processing 
necessary to allocate teleprocessing requests. 


Entry from: TEFAB421. 

Exit to: Caller. 

Called routines: TEFAB434. 

IEFAB426 — Volunit Affinity Processing 

Operation: This module updates volunit table entries to 


reflect volume affinity. It ensures that every member of 
a volume affinity has the same unit identification. 


Entry from: TEFAB423. 

Exit to: Caller. 

Called routines: None. 

IEFAB427 — Allocate Subsystem Data Sets 


Operation: This module controls allocation of subsystem 
data sets. The major functions performed are: 


Find subsystem requests 

Sort subsystem requests 

Issue the IEFSSREQ macro instruction 
Create DSAB/TIOT entries 


Entry from: TEFAB421. 
Exit to: Caller. 


Called routines: IEFAB4F7, IEFAB4SF, subsystems, 
IEFAB428. 


IEFAB428 — Build/Update/Rebuild Expandable TIOT 


Operation: This module creates, updates, or rebuilds the 
expandable TIOT (DSAB/TIOT DD entry). 


Entry from: TEFAB4A3, IEFAB421, IEFAB427, 
IEFAB431, IRFAB434, IEFAB442. 


Exit to: Caller. 

Called routines: TEFAB4E9, IEFAB4FC. 

IEFAB429 — Process Pending Offlines/Unloads 
Operation. This module performs offline/unload 
processing on units or consoles, after the device is 
unallocated. 

Entry from: TEFAB421. 

Exit to: TEFAB421. 

Called routines: TEFAB4GB, IEFAB493, IEFENFFX. 
JEFAB430 — Fixed Device (Main Path) Control 
Operation: This module controls the processing 
necessary to allocate requests to direct access volumes 


that are permanently resident or reserved. 


Entry from. TEFAB421. 
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Exit to: Caller. 
Called routines. TEFAB433, IEFAB436. 
IEFAB431 — Allocate VIO Data Sets 


Operation: This module controls the allocation of VIO 
data set requests. 


Entry from: TEFAB421. 

Exit to: Caller. 

Called routines: IEFAB428. 

TEFAB432 — Affinity Processor 

Operation: This module processes any affinity requests 
to the volume or unit just allocated. Processing 
includes ensuring that the affinity requests are valid 
and, possibly, allocating the requests. 

Entry from: TEFAB434. 

Exit to: Caller. 

Called routines: TEFAB4F2, IEFAB434, TIEFAB441. 
IEFAB433 — Specific Volume Allocation Control 
Operation. This module controls the processing 
necessary to allocate specific volume requests when the 
volume is mounted. A specific request is one that 
requires a particular volume — for example, a volume 
serial number was specified, the data set was passed, 


the data set is cataloged. 


Entry from: TEFAB430, TIEFAB475, IEFAB479, 
TEFAB485. 


Exit to: Caller. 

Called routines: TEFAB434, IEFAB442. 

IEFAB434 — Allocate Request to Unit 

Operation: This module controls the processing 
necessary to allocate a request to the selected device. 


Functions include: 


e Updating the UCB of the selected device (done by 
IEFAB435) 
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e Creating or updating a DSAB and TIOT entry 
(done by IEFAB428) 


e Acquiring space on the volume (interfacing with 
DADSM) 


e Unallocating a unit and decreasing the DALT use 
count (done by IEFHB410), if a DADSM allocate 
error Occurs 


e Processing requests that specify affinity to the 
request being handled (done by IEFAB432) 


Entry from: TEFAB425, IEFAB432, TEFAB433, 
TEFAB436, IEFAB441, IEFAB478, IEFAB479, 
TEFAB489. 


Exit to: Caller. 


Called routines: TEFAB4F2, IEFAB428, IEFAB432, 
TEFAB435, IEFHB410. 


IEFAB435 — Update UCB Routine 


Operation: This module updates the UCB to reflect 
allocation of the current request to it. It also interfaces 
with VM&V control to unload volumes mounted on the 
needed unit. 


Entry from: TEFAB434. 
Exit to: Caller. 


Called routines: TEFAB4E0, IEFAB441, IEFAB493, 
TEFHB410. 


TEFAB436 — Nonspecific Volume Allocation Control 


Operation. This module controls the processing 
necessary to allocate nonspecific, nonprivate requests 
to public and storage volumes. It is responsible for 
building a list of devices that can satisfy the request, 
interfacing with the system resources manager to select 
the device to be allocated, and interfacing with 
IEFAB434 to allocate the request. 


Entry from: TEFAB430, IEFAB475, IEFAB485. 
Exit to: Caller. 


Called routines: TEFAB4F0, IEFAB434, IEFAB440, 
TEFAB442. 
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IEFAB438 — Update DDR Count Routine 

Operation: This.module retrieves the DDR count from 
the CSD. The count is used by module IEFAB424 to 
ensure that allocation is synchronized with DDR while 
the eligible device list (EDL) is being built. 

Entry from: TEFAB424. 

Exit to: Caller. 

Called routines: None. 

IEFAB440 — Build Allocated UCB List 

Operation: This module builds a list of allocated UCBs 
(ALCUCBLT) which is used in the interface with the 


system resources manager. 


Entry from: TEFAB436, IEFAB478, IEFAB489, 
TEFAB490. 


Exit to: Caller. 

Called routines: None. 

IEFAB441 — Volume Validity Checker 

Operation: This module determines if the input volume 
is currently mounted. If it is, this module checks to see 
if the. volume can be used by the current request. 
Entry from: TEFAB432, IEFAB435, IEFAB486. 

Exit to: Caller. 

Called routines: TEFAB434, IEFAB442, IEFAB493. 
IEFAB442 — Affinity Remover 

Operation: This module cancels unit affinity between 
the input request and other requests, when the volume 
being allocated to the input request is permanently 


resident or reserved. 


Entry from: TEFAB433, IEFAB436, IEFAB441, 
IEFAB479. 


Exit to: Caller. 
Called routines: TEFAB4F2, IEFAB428. 
IEFAB445 — Device Allocation Defaults Module 


Operation: This module contains space and unit name 
defaults used by device allocation. 


Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFAB451 — JFCB Housekeeping Control 


Operation: This module is responsible for retrieving the 
information necessary for allocation. 


Entry from: TEFBB404, IEFDB413. 

Exit to: Caller. 

Called routines: TEFAB4EA, IEFAB4F4, IEFAB452. 
IEFAB452 — DD Processing Control 


Operation: This module selects and initiates the 
processing of: 


e STEPCAT requests 
e Other data set requests 


Entry from: TEFAB451. 
Exit to: Caller. 


Called routines: TEFAB4EF, IEFAB4F7, IEFAB453, 
JEFAB454. 


IEFAB453 — DD Preparation 

Operation: This module does the following processing: 

¢ Initializes the pointer to the JFCB for the requests 

e« Processes data set requests that specified QNAME, 
TERM=TS, DUMMY, DSN=NULLFILE, or 
PGM=*, stepname.ddname or PGM=*, 
procstepname.ddname 

e Processes subsystem and VIO data sets 

e Retrieves unit information 


Entry from: TEFAB452. 


Exit to: Caller. 


Module Descriptions 11-95 


Called routines: TEFAB4F7, IEFAB470. 

IEFAB454 — DD Function Control 

Operation: This module determines what additional 
information is required for a DD. It then constructs a 
parameter list and routes control to the appropriate 
routine(s) to obtain that information. 

Entry from: IEFAB452. 

Exit to: Caller. 


Called routines: TEFAB456, TIEFAB457, IEFAB458, 
IEFAB459, IEFAB469. 


IEFAB455 — Passed Data Set Information Scan 
Operation: This module scans the PDI (passed data set 
information) for the data set indicated. If the data set is 
found, it returns a pointer (SVAB) to the SIOT that 
passed the data set. | 

Entry from: TEFAB469. 

Exit to: Caller. 

Called routines: TEFAB4EB, IEFAB4F7. 

IEFAB456 — Data Set Name Resolution 

Operation. This module resolves data set name 
information and provides volume and unit information 
for GDG requests. 

Entry from: TEFAB454. 

Exit to: Caller. 

Called routines: TEFAB461, IEFAB466, IEFAB469. 
IEFAB457 — Volume/Unit Resolution 

Operation: This module receives control for every 
request in order to resolve volume and unit information 
for subsequent allocation processing. 

Entry from: TEFAB454. 

Exit to: Caller. 


Called routines. TEFAB4F7, TEFAB463, IEFAB464, 
IEFAB466, IEFAB469. 
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IEFAB458 — DCB Resolution 


Operation: This module establishes DCB control 
information in a JFCB. 


Entry from. TEFAB454. 

Exit to: Caller. 

Called routines: TEFAB4F7, IEFAB469. 
IEFAB459 — Disposition Processing 
Operation: This module does the following: 


e« Completes data set disposition information in the 
SIOT 


e Updates the PDI (passed data set information), if 
necessary 


e Marks tape data set requests as private, if 
necessary 


e Retrieves catalog information, if necessary 

Entry from: TEFAB454. 

Exit to: Caller. 

Called routines: TEFAB4DC, IEFAB4EB, IEFAB469. 
IEFAB461 — GDG Single Processing 

Operation: This module converts a GDG (generation 
data group) data set request with a relative data set 
name (generation number) to a fully qualified data set 
name. It obtains volume and unit information for a 
GDG single request of an existing data set. 

Entry from: TEFAB456. 

Exit to: Caller. 

Called routines: TEFAB4F7, IEFAB469. 

IEFAB463 — Multiple Device Type Determination 


Operation: This module scans the catalog return 
information(CRI) to: 


¢ Determine if the data set is a multi-device type data 
set and, if so, to return the number of different 
device types minus one 
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e Given the number of device types, find and return 
the respective device type and a pointer to the 
volume list entry for that device type 

Entry from: TEFAB457, IEFAB464. 

Exit to: Caller. 

Called routines: None. 

IEFAB464 — Volume Unit Table Completion 

Operation: This module copies appropriate volume and 

unit information from the source determined by 

previous routines. 

Entry from: TEFAB457. 

Exit to: Caller. 

Called routines: TEF AB4F7, TIEFAB463, IEFAB470. 

IEFAB466 — Table Creation 


Operation: The module creates SIOTs/JFCBs and 
initializes them. 


Entry from: TEFAB456, TEFAB457, IEFAB469. 

Exit to: Caller. 

Called routines: TEFAB4FD, IEFAB4F7. 

IEFAB469 — JLOCATE 

Operation: JLOCATE is a housekeeping service routine 
that provides data set name information for GDG 
single requests and necessary volume and unit 


information for a given data set name. 


Entry from: TEFAB454, IEFAB456, TIEFAB457, 
TEFAB458, TIEFAB459, IEFAB461. 


Exit to: Caller. 
Called routines: TEFAB4EF, IEFAB4F5, IEFAB466. 
IEFAB470 — Unit Name Conversion 


Operation: This module extracts necessary EDT or 
UCB device information from the current SIOT. 


Entry from: TEFAB453, IEFAB464. 


Exit to: Caller. 

Called routines: None. 

IEFAB471 — Generic Allocation Control 

Operation: This module controls the allocation of 
requests that could not be handled by fixed device 
allocation. (See IEFAB430.) It handles requests to any 
mounted volumes and/or to any online and unallocated 
units. It processes one generic device type at a time. 
The order of processing is determined by the 
installation device precedence list. 

Entry from. TEFAB421. 

Exit to: Caller. 


Called routines: TEFAB4FA, IEFAB472, TIEFAB473, 
IEFAB475. | 


IEFAB472 — Build Tables for Generic Processing 


Operation: This module builds the tables needed for 
generic allocation processing. The tables built are: 


e Allocation queue manager request block 
e Cover/reduce algorithm interface tables 
e« Request identification mask table 

e Workarea for manipulating group masks 
Entry from: TEFAB471. 

Exit to: Caller. 

Called routines: TEF AB4FA, TEFAB481. 


TEFAB473 — AVR (Automatic Volume Recognition) 
Control 


Operation: This module reads the volume label of any 
volumes mounted on units whose UCBs are passed as 
input. 

Entry from: TEFAB471. 

Exit to: Caller. 


Called routines: TEFAB4E0, TIEFAB4F8, TIEFAB4F9, 
TEFAB493, TIEFXVNSL. 
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IEFAB474 — Process Multi-Unit /Multi-Generic 
Requests 


Operation: This module determines if a multi-unit 
(multi-generic) request processed by the algorithm is 
assigned to a single generic device type. If not, this 
module attempts to find a single generic device type 
that can satisfy the request. 


Entry from: TEFAB476, IEFAB486. 

Exit to: Caller. 

Called routines: TEFAB481. 

IEFAB475 — Allocate within a Generic 

Operation: This module attempts to allocate as many 
requests as possible to the chosen generic device type. 
It determines what types of allocation are required and 
then calls the necessary allocation routines. 

Entry from: JEFAB471. 

Exit to: Caller. 


Called routines: TEFAB433, IEFAB436, IEFAB476, 
TEFAB479. 


IEFAB476 — Allocate via the Algorithm 


Operation: This module processes requests when a 
choice of units exists, that is when a specific unit is not 
requested; the request cannot be satisfied by allocating 
it to a mounted volume; or the request cannot be 


allocated to a permanently resident or reserved volume. 


IEFAB476 calls the cover/reduce algorithm 
(IEFAB480) to select the device groups from which to 
allocate. 

Entry from: TEFAB475, IEFAB485. 

Exit to: Caller. 


Called routines: TEFAB474, IEFAB477, IEFAB478, 
TEFAB480. 


IEFAB477 — Unallocate Requests to be Rearranged 


Operation: This module unallocates requests that the 
algorithm indicates must be rearranged. 


Entry from: TEFAB476, IEFAB485, IEFAB486. 


Exit to: Caller. 
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Called routines: TEFAB4A0, IEFAB493, IEFHB410. 


IEFAB478 — Allocate From Groups Picked by 
Algorithm 


Operation. This module allocates requests to available 
(that is, online, unallocated) devices within the device 
groups selected by the algorithm. 

Entry from: TEFAB476, IEFAB486, IEFAB491. 

Exit to: Caller. 

Called routines: TEFAB434, IEFAB440, ICBME. 
IEFAB479 — Demand Allocation 

Operation: This module allocates requests that specify a 
specific unit address (for example, unit=190) within 
the generic device type being processed by generic 
allocation. 

Entry from: TEFAB475, IEFAB485, IEFAB491. 

Exit to: Caller. 


Called routines: TEFAB4F0, TEFAB433, IEFAB434, 
TEFAB442. 


IEFAB48A — Process Offlines/ Allocated Units 


Operation: This module controls the processing 
necessary: 


e To determine whether a request can be satisfied by 
offline and/or allocated units 


¢ To inform the operator of the possible options 
Entry from: TEFAB487. 

Exit to: Caller. 

Called routines: TEFAB4F3, IEFAB488, IEFAB489. 
IEFAB480 — Cover/Reduce Algorithm 

Operation: This module uses the hungarian algorithm to 
determine which group or groups of devices should be 


used to satisfy a generic allocation request. 


Entry from: TEFAB476, IEFAB486, IEFAB488, 
TEFAB489, IEFAB491. 
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Exit to: Caller. 
Called routines: None. 
IEFAB481 — Eliminate Ineligible Groups and Generics 


Operation: This module marks all generic device types, 
except the one selected for the current request, as 
ineligible in the EDL. It also marks group list entries in 
the algorithm tables as ineligible, when the groups are 
not in the selected generic device type. 


Entry from: TEFAB4F2, IEFAB472, TEFAB485, 
TEFAB486. 


Exit to: Caller. 

Called routines: None. 

IEFAB485 — Recovery Allocation 

Operation: This module handles allocation requests that 
could not be allocated by either Fixed Device Control 
or Generic Allocation. Offline and/or allocated units 
can be considered during these allocations, if necessary 
and if allowed by the caller. 

Entry from: TEFAB421. 

Exit to: Caller. 

Called routines: TEFAB4FA, TIEFAB433, IEFAB436, 
TEFAB476, IEFAB477, IEFAB479, IEFAB481, 
IEFAB486, IEFAB49C. 

IEFAB486 — Offline/ Allocated Device Allocation 
Operation: This module handles allocation processing 
when it is necessary to consider offline and/or 
allocated devices. 

Entry from. TEFAB485. 

Exit to: Caller. 

Called routines: TEFAB4FA, TIEFAB441, IEFAB474, 
TEFAB477, IEFAB478, IEFAB480, IEFAB481, 
IEFAB487, IEFAB493. 


IEFAB487 — Allocation Recovery Interface With 
Operator 


Operation: This module controls the processing 
necessary to inform the system operator that this 
allocation cannot proceed without waiting for devices 


to be unallocated by other jobs and/or bringing needed 
devices online. 


Entry from: TEFAB486. 

Exit to: Caller. 

Called routines: TEFAB4F3, IEFAB48A, IEFAB488. 
IEFAB488 — Recovery Reply Options Processor 
Operation: This module builds and issues the 
appropriate reply options message and processes the 
operator’s reply. 

Entry from: TEFAB48A, TIEFAB487. 

Exit to: Caller. 


Called routines. TEFAB4F3, IEFAB480, IEFAB489, 
IEFENFFX. 


IEFAB489 — Recovery Allocation of Online Devices 
Operation: This module determines, for each group of 
UCBs in the system, whether the number of online 
units in the group has increased as a result of the 
system operator’s responses to the reply options 
message. If it has, the routine will attempt to allocate 
requests to the units in the group. 

Entry from: TEFAB48A, IEFAB488. 

Exit to: Caller. 


Called routines: TEFAB434, IEFAB440, IEFAB480, 
ICBME. 


IEFAB49A — VM&V DOMR & Cleanup Routine 
Operation: This module deletes mount messages, if 
necessary, and release used by this allocation when all 


mount messages have been deleted. 


Entry from: TEFAB4E2, IEFAB4E8, IEFAB492, 
TEFAB496. 


Exit to: Caller. 


Called routines: TEFAB498. 
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IEFAB49B — Device End POST Handler 
Operation: This module verifies, if necessary, that: 


e Adevice is now ready (that is, a volume has been 
mounted); or, 


e The volume mounted on the device is acceptable in 
response to a mount message issued by mount 
control or a mount request to the 3850 mass 
storage system. 

Entry from: TIEFAB496. 

Exit to: Caller. 

Called routines: TEFAB4F3, IEFAB4F8, IEFAB493. 

IEFAB49C — Non-Allocation Unload Interface 

Operation: This module interfaces with volume mount 

and verify (VM&V) control (IEFAB493) to have 

volumes unloaded and/or rewound for non-allocation 
callers. Before calling IEFAB493, this routine verifies 
the UCB pointers in each VM&V request block (RB). 


Entry from: IATLVVR, IATSICA, IEEMB813, 
IEEVCPRL, or IEEVPTH. 


Exit to: Caller. 

Called routines: TEFAB493. 

JEFAB490 — Common Allocation Cleanup 

Operation: This module performs cleanup functions 
when allocation has completed or when a terminating 
allocation error has been detected. 

Entry from: TEFAB421. 

Exit to: Caller. 


Called routines: TEFAB4A0, IEFAB4EEF, IEFAB4FA, 
TEFAB4FD, IEFAB4F3, IEFAB421, TEFAB492. 


IEFAB491 — Wait Holding Resources 


Operation: This module waits for other job steps to 
unallocate devices in the device groups from which this 
allocation needs additional units. When posted because 
of an unallocation, this routine tries to satisfy the 
remaining requests. 
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Entry from: TEFAB421. 
Exit to: Caller. 


Called routines: TEFAB4FA, IEFAB478, IEFAB479, 
TEFAB480, IEFAB493. 


IEFAB492 — Allocation/ VM&V Interface 

Operation: This module interfaces with VM&V Control 
(IEFAB493) to process volume mount and verify 
requests (represented by VM&V request blocks build 
during generic and recovery allocation). 

Entry from. TEFAB490. 

Exit to: Caller. 


Called routines: TEFAB4A0, IEFAB4FA, IEFAB4F0, 
IEFAB49A, IEFAB493, TEFAB498. 


JEFAB493 — Volume Mount and Verify (VM&V) 
Control 


Operation: This module controls unload, mount, and 
verify processing; it scans VM&V request blocks and 
calls unload control (IEFAB494), mount control 
(IEFAB495), and verify control (TEFAB496) to 
process the requests. 

Entry from: TEFAB4A4, IEFAB429, TEFAB435, 
IEFAB441, IEFAB473, IEFAB477, IEFAB49B, 
IEFAB49C, IEFAB491, IEFAB492, or IEFABB416. 
Exit to: Caller. 

Called routines: TEFAB494, TEFAB495, TEFAB496. 
IEFAB494 — Volume Unload Control 


Operation: This module processes all requests to: 


e Rewind or rewind and unload tape volumes 
e Unload direct access volumes 


Entry from: TEFAB493. 
Exit to: Caller. 


Called routines: TEFAB4E0, IEFAB4F3, IEFAB499, 
TEFENFFX. 
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IEFAB495 — Mount Control Routine 

Operation: This module builds mount control blocks. 
For mass storage system (MSS) volume requests, this 
module interfaces with the 3850 mass storage system to 
mount the volumes. For non-MSS volume requests, this 
module issues mount WTO or WTOR messages. 

Entry from: TEFAB493. 

Exit to: Caller. 

Called routines. TEFAB4E0, TIEFAB498, TEFAB499. 
IEFAB496 — Verify Control Routine 

Operation: This module handles all verify device end 
and verify label requests by waiting for the specified 
units to become ready. In the case of verify label, this 
module also ensures that the requested volume has 
been mounted. 

Entry from: TEFAB493. 

Exit to: Caller. 


Called routines: TEFAB49A, IEFAB49B, IEFAB498, 
IEFAB499. 


IEFAB498 — MVCA Chain Processor 


Operation: This module is invoked to perform one of 
the following functions: 


« Search the MVCA chain for the MVCA for this 
allocation. 

e Add an MVCA to the MVCA chain. 

e Delete an MVCA from the MVCA chain. 


Entry from: TEFAB4E2, IEFAB4E5, IEFAB4E8, 
IEFAB49A, IEFAB492, IEFAB495, IEFAB496. 


Exit to: Caller. 

Called routines: None. 

IEFAB499 — VM&V WTO/WTOR Format Routine 
Operation: This module builds WTO/R or multiline 
WTO/R parameter lists for MOUNT and UNLOAD 
and VERIFY messages using information supplied by 
the caller. 

Entry from: TEFAB494, IEFAB495, IEFAB496. 


Exit to: Caller. 


Called routines: None. 

IEFAB820 — TCTIOT Construction Interface 
Operation: This module determines whether SMF 
accounting functions are required, initializes the TCT 


storage map, and calls IEFIB660 to build the TCTIOT. 


Entry from. IEFSD263 via CALL (to IEFSMFAT, alias 
for IEFAB820). 


Exit to: IEFSD263 via branch. 

IEFAUINT — Assign/Unassign Initialization Service 
Operation: This module assigns one or all on-line 
assignable devices. It is invoked by JES2 during 
initialization to assign all assignable devices with the 
ASGNALL function. It is also invoked by JES3 during 
main device scheduling initialization using the 
ASGNALL function for devices that are not _ 
JES3-managed and the ASGNONE function for the 
individual assigning of JES3-managed devices. 

Entry from: JES2 or JES3. 

Exit to: Caller. 

Called routines: TEFAUSRV, IOSVSUCB, IEFAB4GB. 
IEFAUSRV — Hardware Assign/Unassign Service 
Operation: This module is invoked by IEFAUINT and 
other system components to assign a device, unassign a 
device, restore status of a device and build the CCWs 
to restore the assign status of a device. 

Entry from: JES3, IEFAB488, IEFAB429, 
IECVIOPM, IEFAUINT, IECVGENA, IECVRRSV, 
IECVRSTI. 

Exit to: Caller. 

Called routines: None. 

IEFBB4M1 — Job Status Messages 


Operation: This module contains the message text for 
the allocation job status operator messages. 


Entry from: Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 
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Called routines: Not applicable (non-executable 
module). 


IEFBB4M2 — Allocation Step-Related Messages 
Operation. This module contains the message text of 
allocation step-related error messages that are issued to 
the system output data set. 

Entry from: Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFBB4M3 — Allocation DD-Related Messages 
Operation: This module contains the message text of the 
allocation DD-related error messages that are issued to 
the system output data set. 

Entry from: Not applicable (non-executable module). 


Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFBB4M4 — WTO Messages for IEFBB410 


Operation: This module contains the message text of the 
unallocation job status messages. 


Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFBB4MS — Unallocation Messages 


Operation: This module contains the message text of the 
unallocation error messages. 


Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 
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IEFBB401 — Initiator/ Allocation Interface 


Operation: This module controls the interface between 
the initiator and step allocation control. (It determines 
the path that a step or job will take through the 
initiator. ) 


Entry from: TEFSD162. 
Exit to: Caller. 


Called routines: TEEAB401, IEFAB4A6, IEFAB4FC, 
IEFAB4FD, IEFAB4FE, IEFAB4F3, IEFAB4F7, 
IEFBB402, IEFBB404. 


IEFBB402 — Test EXEC Statement Condition Codes 


Operation: This module determines, from the 
specifications of the COND parameter on the EXEC 
statement, whether the step should be bypassed or 
executed. 


Entry from: TEFBB401. 

Exit to: Caller. 

Called routines: TEFAB4FD, IEFAB4F7. 
IEFBB404 — Step Allocation Control 

Operation: This module receives control when a job 
step is to be allocated; it controls the following 
functions: 

JFCB housekeeping 

Common allocation processing 


Reordering and compressing the TIOT 
Writing DD-related error messages 


Entry from: TEFBB401. 
Exit to: Caller. 


Called routines: TEFAB4FC, TIEFAB4FD, IEFAB4F3, 
TEFAB421, IEFAB451. 


IEFBB410 — Initiator /Unallocation Interface 
Operation: This module provides an interface between 
the initiator and step unallocation. SIOTs, JFCBs, and 
JFCBXs are located and chained, end-of-step messages 


are issued, and step unallocation is invoked. 


Entry from: TEFSD 164. 
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Exit to: Caller. 


Called routines: TEEAB401, IEFAB4FC, IEFAB4FD, 
TEFAB4FE, TEFAB4F7, IEFAB412, IEFBB414, 
TEFBB416, IEFRPREP, IEFTB721. 


IEFBB412 — Process Job Condition Codes 


Operation: This module compares the return code from 
the step just executed with the dependency codes 
specified in the COND parameter on the JOB 
statement. 


Entry from: TEFBB410. 

Exit to: Caller. 

Called routines: None. 

TEFBB414 — Step Unallocation Control 


Operation: This module creates the interface to 
Common Unallocation for the job step being 
terminated. This involves building a request block for 
each SIOT on the input SIOT chain and determining 
the processing required for each of these requests. 
Allocation messages are also built and issued if 
requested. 


Entry from: TEFAB4DD, IEFBB410. 

Exit to: Caller. 

Called routines: TEFAB4A0, TIEFAB4EE. 

IEFBB416 — Job Unallocation 

Operation: This module performs disposition processing 
for passed unreceived data sets and unloads volumes no 
longer needed by this job. 

Entry from: IEFAB4DD, TEFBB410. 

Exit to: Caller. 


Called routines: TEFAB4A0, IEFAB4EB, IEFAB4F3, 
IEFAB4F7, IEFAB493. 


IEFDB4A0 — Dynamic Unallocation Control! Routine 


Operation: TEFDB4A0 handles Dynamic Allocation 
(SVC99) requests for unallocation. It checks the 
validity of the request, determines what DSABs should 
be processed and what processing should be done for 
them (Unallocation or remove in-use), and invokes the 
necessary routine(s) to perform the processing. 


Entry from: TEFDB400, IEFDB410. 
Exit to: Caller. 


Called routines: TEFDB4A1, IEFDB4FA, IEFDB4FC, 
IEFDB4FF, IEFDB460, IEFDB481. 


IEFDB4A1 — Dynamic Unallocation Processor 
Operation: This module receives control from either 
Unallocation Control (IEFDB4A0), or Remove In-use 
Processor (IEFDB481) to perform Unallocation 
Processing for DSABs pointed to by the input list of 
DSABPTRs. 

Entry from: TEFDB4A0, IEFDB481. 

Exit to: Caller. 


Called routines: TEFAB4A0, IEFAB4DC, IEFAB4F7, 
IEFDB4F9. 


IEFDB4D0 — DAIR - Dynamic Allocation Interface 
Routine 


Operation: In a TSO environment, this module serves as 
an interface from various command processors to 
dynamic allocation. 


Entry from: Various command processors and user 
programs. 


Exit to: Caller. 


Called routines: TEFDB400 (via SVC 99), IKJEHCIR 
(via LINK). 


IEFDB4FA — Dsname Search Routine 

Operation: This module searches the DSABs and JFCBs 
for the data set name requested by the user. If the 
dsname is allocated to the current task, the address of 
its DSAB is returned to the caller. 

Entry from: TEFDB4A0, IEFDB470. 

Exit to: Caller. 


Called routines: None. 
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IEFDB4FB — Change DDNAME/JESS3 Exit 


Operation: This module interfaces with the JES3 
subsystem whenever a DDNAME or relative position 


number change has been made by Dynamic Allocation. 


Entry from: IEFDB410, IEFDB411, IEFDB450. 
Exit to: Caller. 

Called routines: None. 

IEFDB4FC — Ddname Search Routine 

Operation: This module searches the TIOT for a 
specific ddname. It begins its search at the starting 


DSAB address passed as input by the caller. 


Entry from. IEFDB4A0, IEFDB4FD, IEFDB414, 
IEFDB450, IEFDB460, IEFDB470, TIEFDB490. 


Exit to: Caller. 
Called routines: None. 
IEFDB4FD — Ddname Generation Routine 


Operation: This routine generates an eight character 
ddname. 


Entry from: TEFDB410, TEFDB414. 

Exit to: Caller. 

Called routines: TEFDB4FC. 

IEFDB4FE — Obtain DSORG Routine 

Operation: This module determines the data set 
organization for the data set associated with the input 
DSAB. 

Entry from: IEFDB410, IEFDB413, IEFDB470. 
Exit to: Caller. 

Called routines: None. 

IEFDB4FF — Syntax Checker 

Operation: This module determines whether the user 


has entered an invalid key, mutually exclusive keys, or 
duplicate keys. It also checks whether an invalid 
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number of parameters has been entered with each key, 
and whether the length of each parameter value is 
valid. 


Entry from: IEFDB4A0, IEFDB4F0, IEFDB450, 
IEFDB460, IEFDB470, IEFDD480, IEFDB490. 


Exit to: Caller. 

Called routines: None. 

IEFDB4F0 — Key Verification 

Operation: This module invokes the syntax checker 
(IEFDB4FF) to syntax check the text units with 
non-JDT-defined keys and invokes SJF (IEFSJCNL) 
to syntax check the text units with JDT-defined keys. 
Entry from: TEFDB412. 

Exit to: Caller. 

Called Routines: TEFDB4FF and IEFSJCNL. 
IEFDB4F8 — Allocate TCTIOT Control 

Operation: Following a dynamic allocation, this module 
updates an existing TCTIOT or obtains and updates a 
new TCTIOT if the existing TCTIOT cannot be 
expanded. 

Entry from: TEFDB4F9. 

Exit to: Caller. 

Called routines: None. 

IEFDB4F9 — SMF Dynamic DD Routine 

Operation: This module updates the TCTIOT to reflect 
any changes made to the TIOT as a result of a dynamic 
allocation, unallocation, concatenation, or 
deconcatenation. If the function is unallocation, 
concatenation, or deconcatenation, an SMF type 40 


record is built and written. 


Entry from. IEFDB4A1, IEFDB413, IEFDB450, 
IEFDB460, IEFDB400. 


Exit to: Caller. 


Called routines. TEEMB848, IEFDB4F8. 
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IEFDB400 — Dynamic Allocation Control Routine 


Operation: To process the input request, this module 
routes control to one of the following functions: 
dsname allocation, ddname allocation, concatenation, 
deconcatenation, remove in-use attribute, information 
retrieval or unallocation. 


Entry from: SVC interrupt handler. 
Exit to: Caller. 


Called routines: TEFAB4FE, IEFAB4F7, IEFDB4A0, 
IEFDB401, IEFDB410, IEFDB450, IEFDB460, 
IEFDB470, IEFDB480, IEFDB490, IEFDB4F9. 


IEFDB401 — Dynamic Allocation Installation Exit 


Operation: The Dynamic Allocation facility of the 
control program exits to this Validation Routine’ 
before doing any processing on behalf of a Dynamic 
Allocation request. It is entered for all requests, 
foreground and background. This routine may test and 
modify the Dynamic Allocation input, and indicate 


through a return code whether processing is to continue 


or if the request is to be terminated. This IBM version 
arbitrarily accepts all requests. 


Entry from: IEFDB400. 

Exit to: Caller. 

Called routines: None. 

IEFDB402 — Dynamic Allocation ESTAE Exit 
Operation: This module performs clean-up processing 
when the task under which SVC 99 is executing 
abnormally terminates. 

Entry from: TEFAB4ED. 

Exit to: Caller. 

Called routines: TEFDB418. 

IEFDB403 — TCTIOT FRR Routine 

Operation: This exit routine receives control if an 
ABEND occurred while TCTIOT updating was taking 


place. This module sets to zero the pointer to the 
TCTIOT if it is unuseable and frees TCTIOT storage. 


Entry from: RTM (recovery termination management). 


Exit to: Caller. 
Called routines: None. 
IEFDB410 — Allocate Function Control 


Operation: This module is the control routine for the 
dynamic allocation of a data set. 


Entry from: IEFDB400. 

Exit to: Caller. 

Called routines. TEFAB4F7, IEFDB4A0, IEFDB4FD, 
IEFDB4FE, IEFDB411, IEFDB412, IEFDB413, 
IEFDB460, IEFDB4FB. 

IEFDB411 — Dynamic Allocation Convert Routine 


Operation: This module modifies an existing allocation 
to satisfy the user’s request. 


Entry from: TEFDB410. 
Exit to: Caller. 
Called routines: TEFAB4DC, TEFAB4E9, IEFDB417. 


IEFDB412 — Dynamic Allocation Function Validity 
Checker 


Operation: This module validity checks the allocation 
function’s input text against invalid, duplicate, or 
mutually exclusive keys; invalid number of keyword 
parameters or parameter lengths; absence of mutually 
inclusive parameters; invalid parameter values; and 
improper authorization to request a subsystem data set. 
Entry from: TEFDB410. 

Exit to: Caller. 

Called routines: TEFDB4FO0. 

TEFDB413 — Normal Dynamic Allocation Control 


Operation: This routine controls the processing for a 
normal dynamic allocation request. 


Entry from: TEFDB410. 


Exit to: Caller. 
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Called routines: TEFAB4A0, IEFAB4DC, IEFAB4FC, 
IEFAB4F7, TEFAB421, TEFAB451, IEFDB4FE, 
IEFDB4F9, [IEFDB414, IEFDB418. 


IEFDB414 — Build SWA Tables For Dynamic 
Allocation Request 


Operation: This module creates and sets up a SIOT, 
JFCB, and if necessary, JFECBX(s), and/or a SSWA. 


Entry from: TEFDB413. 
Exit to: Caller. 


Called routines: TEFAB4F7, IEFDB4FC, IEFDB4FD, 
IEFDB417, IEFSJCNL. 


IEFDB417 — Dynamic Allocation JFCB - DCB Field 
Update 


Operation: This module updates fields in the JFCB for 
DCB keys specified in the user’s request. 


Entry from: TEFDB411, IEFDB414. 
Exit to: Caller. 
Called routines: None. 


IEFDB418 — Dynamic Allocation Normal Error 
Subroutine 


Operation: This module serves as a subroutine for clean 
up processing if an error occurs in dynamic allocation. 
It releases resources acquired during processing of a 
dynamic allocation request and ensures that the 
"WRITE-EPA’ chain is written to SWA. 

Entry from: TEFDB402, IEFDB413. 

Exit to: Caller. 

Called routines: TEFAB4A0, IEFAB4DC, IEFAB4F7. 
IEFDB450 — Concatenation Routine 

Operation: This module concatenates existing 
allocations in the order in which they are specified in 
the input text units. 

Entry from: IEFDB400. 

Exit to: Caller. 


Called routines: TEFAB4FC, IEFAB4F7, IEFDB4FB, 
IEFDB4FC, IEFDB4FF, IEFDB4F9. 
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IEFDB460 — Deconcatenation Routine 

Operation: This module disassociates members of a 
dynamically concatenated group by restoring the 
pre-concatenation ddnames to the members and 
removing the "Dynamically Concatenated’ 
(DSABDCAT) and ’Member of a Concatenated 
Group’ (DSABCATM) attributes from the respective 
DSABs. 

Entry from: IEFDB4A0, IEFDB400, IEFDB410. 
Exit to: Caller. 

Called routines. TEFAB4FC, IEFDB4FF, IEFDB4F9. 
IEFDB470 — Dynamic Information Retrieval 


Operation: This module provides the user with 
information about his current allocation environment. 


Entry from: TEFDB400. 
Exit to: Caller. 


Called routines: TEFDB4FA, IEFDB4FC, IEFDB4FE, 
TEFDB4FF. 


IEFDB480 — Remove In-Use Control Routine 
Operation: This module handles dynamic allocation 
(SVC 99) requests for remove in-use processing. It 
validity checks the request, determines what DSABs 
should be processed, and invokes the remove in-use 
processor (IEFDB481): 

Entry from: TIEFDB400. 

Exit to: Caller. 

Called routines. TEFDB4FF, IEFDB481. 

IEFDB481 — Remove In-Use Processor 


Operation: This module performs remove in-use 
processing for the DSABs pointed to by the input list. 


Entry from: IEFDB4A0, IEFDB480. 
Exit to: Caller. 


Called routines: TEFDB4A1. 


Licensed Material — Property of IBM 


IEFDB490 — Ddname Allocation 


Operation: This module assigns the in-use attribute to 
the resource associated with the specified ddname. 


Entry from. IEFDB400. 

Exit to: Caller. 

Called routines: TEFDB4FC, IEFDB4FF. 
IEFDPOST — Device Interrupt Routine 


Operation. This module is invoked by IOS to post tasks 
waiting for devices to become ready. 


Entry from: IOS (input/output supervisor). 
Exit to: Caller. 
Called routines. TEAOPTO1. 


IEFDSLST — Data Set Enqueue Parameter List 
Builder 


Operation: This module builds a data set enqueue 
parameter list for each job; to do this, it uses input 
passed by IEFDSTBL. 

Entry from: TEFSD161 via branch. 

Exit to: TEFSD161 via branch. 

IEFDSTBL — Data Set Tree Builder 

Operation: This module eliminates duplicate data set 
names from the data set enqueue parameter list that 
exists for each job. 

Entry from: TEFSD161 via branch. | 

Exit to: TEFSD161 via branch. 

IEFEB400 — EDT Verification Routine 

Operation: This module verifies that the devices defined 
by the EDT contained in the input data set match the 
devices currently existing in the nucleus. 


Entry from: Program manager. 


Exit to: Caller. 


IEFENFDM — Event Notification Control Table 


Operation: This module contains the event notification 
control table (IEFENFCT). 


Entry from: Not applicable ieaccreatiable module). 
Exit to: None. 

IEFENFFX — Event Notification Request Router 
Operation: This module checks the event parameter list 
and determines if the request is synchronous or 
asynchronous. 

Entry from: Event notification user. 

Exit to: Caller. 

Called routines: TEFENFNM. 

IEFENFNM — Event Notification Mainline 


Operation: Thisbmodule processes all event notification 
listen, signal, and delete listen requests. 


Entry from: TIEFENFWT, IEFENFFX. 
Exit to: Caller. 
IEFENFWT — Event Notification Wait Routine 


Operation: This module handles processing of 
asynchronous event notification requests. 


Entry from: [EEMB860 via ATTACH and IEFENFFX 
via POST. 


Exit to: None, this is a never ending task. 
Called routines: TEFENFNM. 
JEFHB4I1 — Allocation Address Space Initialization 


See OS/VS2 System Initialization Logic for a module 
description of IEFHB4I1. 


IEFHB412 — Display Allocation Scavenge Routine 


See OS/VS2 System Initialization Logic for a module 
description of IEFHB4I2. 
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IEFHB410 -— Display Allocation Tables Manager 


Operation: This module handles all updates to the 
display allocation tables in the allocation address space 
(ALLOCAS). DEFHB410 executes in cross memory 
mode. It is entered by means of a program call (PC) to 
perform one or more of the following functions. 


e Updates the DALT use count field 

e Returns the DALT use count for a unit 

¢« Returns the DALT use count for one address space 
and one unit 

e Clears the DALT for an address space 


Entry from: TEFAB4A4, TEFAB4E5, IEFAB4E6, 
TEFAB434, TEFAB435, TEFHB412, IEFAB477. 


Exit to: Caller by means of a program transfer (PT). 
JEFIB600 — Initiator /Subsystem SWA Interface 
Operation. This module builds the JSCB chain for a job, 
invokes the interpreter, and builds a CSCB for a job 
that is not a started task or LOGON. 


Entry from: The master subsystem or the job entry 
subsystem via LINK. | 


Exit to: Caller via branch. 

IEFIB60S — SWA Reconstruction Module 

Operation: This module reconstructs SWA for restarted 
jobs by invoking the SWA merge routine and the data 
set description record processor. 

Entry from: TEFTB605 via CALL. 

Exit to: Caller via branch. 

IEFIB620 — ESTAE Exit Routine 

Operation: Depending upon what type of error caused 
this module to receive control, it records the error and 
then either takes a dump or prepares for a retry. 

Entry from. IEAVTAS1 via a SYNCH macro. 

Exit to: TEAVTAS1 via branch. 

IEFIB621 — Initiator Task Recovery Retry Routine 


Operation: This module attempts to resume normal 
initiator processing after a program check, an ABEND, 
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or machine check has occurred, or after an operator has 
pushed the RESTART key. 

Entry from: This module receives control and executes 
as a result of an RB (request block) created by the 
recovery termination management routines. 

Exit to: TEFSD164 via branch. 

TEFIB645 — SWA Create Exit Routine 

Operation: This module receives control whenever an 
error has occurred during interpreter, restart, or SWA 
create interface processing. It records the error on the 


system error record data set and then attempts a retry. 


Entry from: Recovery termination management via 
LINK. 


Exit to: Caller via branch. 

IEFIB650 — Initiator Message Module 

IEFIB660 — Build TCTIOT Routine 

Operation: This module constructs a TCTIOT based on 
the current TIOT. If a TCTIOT exists on entry to this 
module, it is freed. This situation could occur if 
dynamic allocation obtained a TCTIOT prior to 
initiation. 

Entry from: TEFAB820. 

Exit to: Caller. 


Called routines: None. 


IEFICATL —- Initiator Interface to Allocate Catalog 
Control 


Operation: This module determines the data set names 
of each catalog to be used by a jobstep/task and then 
invokes IEFAB4F5 to open the catalogs. 

Entry from: TEFSD162 via BALR. 

Exit to. TEFSD162 via branch. 

IEFICPUA — Assignment of CPU Task Affinity 
Operation: This module indicates to the calling module 
which processor(s) can be used to run a jobstep/task; 


it also notifies the calling routine if the required 
processor(s) is not on line. 
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Entry from: TEFSD101 for the first jobstep in a job and 
from IEFSD101 for subsequent steps. 


Exit to: The calling module via branch. 

IEFIIC — Initiator Interface Control 

Operation: This module puts the initiator routines into 
supervisor state and builds the initiator’s SSIB, SSOB 
header, entrance, options, and exit list (IEL). 

Entry from: TEFSD263 via ATTACH. 

Exit to: IEFSD060 via branch. 

IEFIMASK — Conversion of Bit Mask 

Operation: This routine converts bit positions in a string 
to hexadecimal characters for inclusion in some 
initiator messages. 

Entry from: TEFSD101 or IEFSD161 via branch. 

Exit to: The calling module via branch. 

IEFIRECM — Initiator Resource Manager 

Operation: This module cleans up resources used by the 
initiator in a terminating address space. This routine 
deletes all CSCBs associated with this address space 
from the CSCB chain. 

Entry from: RTM (via address in CVTIRECM field). 
Exit to: RTM. 

IEFISEXR — Initiator Subsystem ESTAE Exit Routine 
Operation: This module receives control after an 
abnormal situation occurs in the initiator or subsystem 
interface resource managers. It issues a DEQ for the 
CSCB chain and makes an error entry in the LOGREC 
data set. 

Entry from: RTM (via address in CVTJRECM field). 
Exit to: RTM. 

IEFI922B — Builder of 922 Completion Code Interface 
Operation: This routine builds an interface to module 
IEFSD164 to enable the termination of a jobstep/task 


which has already successfully completed allocation 
processing. 


Entry from: TEFIB621 via CALL. 

Exit to. TEFIB621 via branch. 

IEFJACTL — Pseudo Access Method Control 
Operation: This routine, a part of the master subsystem, 
provides a data manipulation service for the converter 
and interpreter at a time when no access method 
services are available via the RPL/ACB interface. 
Entry from: The converter or interpreter. 


Exit to: Caller. 


Error exit. To caller’s ESTAE routine with a user abend 
code X’0B1’ or X’0B3’. 


IEFJCDLT — Storage Deletion Routine 

Operation: This routine, a part of the master subsystem, 
frees the storage no longer needed by the master 
subsystem after creating SWA control blocks for a task. 
Entry from: IEFJJOBS. 

Exit to: Caller. 

IEFJCNTL — JCLS to SWA Conversion 

Operation: This routine, a part of the master subsystem, 
converts a JCLS chain to SWA control blocks by 
invoking the converter, then the interpreter (via the 
SWA-create interface). 

Entry from: TEFJJOBS. 

Exit to: Caller. 


Error exit: To caller’s ESTAE routine with a user abend 
code X’0B1’, X’0B4’, or X’0B5’. 


IEFJDIRD — Pseudo Access Method Direct Read 
Operation: This routine, a part of the master subsystem, 
moves the specified record into a specified buffer so 
that the record can be updated. 

Entry from: The converter via the RPL/ACB interface. 


Exit to: Caller. 
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IEFJDSNA — Data Set Name Assignment 

Operation: This routine, a part of the master subsystem, 
assigns a data set name to each SYSOUT data set 
specified in the master JCL or in the JCL used to start 
a job entry subsystem. 

Entry from: Allocation. 

Exit to: Caller. 

IEF JDWRT — Pseudo Access Method Direct Write 
Operation: This routine, a part of the master subsystem, 
overlays an old record with an updated record from a 
buffer. 

Entry from: The converter via the RPL/ACB interface. 
Exit to: Caller. 

IEFJJCLS — JCL to JCLS Conversion 

Operation: This routine, a part of the master subsystem, 
converts the master scheduler JCL (MSTRJCL) toa 
JCLS chain. 

Entry from: IEFJJOBS. 

Exit to: Caller. 


Error exit. To caller’s ESTAE routine with a user abend 
code X’0B1’. 


IEFJJOBS — Subsystem Initiation 

Operation: This routine, a part of the master subsystem, 
controls the creation of SWA control blocks when the 
master scheduler or a job entry subsystem is being 
started. 

Entry from: The initiator via the subsystem interface. 


Exit to: The initiator. 


Error exit. To caller’s ESTAE routine with a user abend 
code X’0B1’. 


IEFJJTRM — Subsystem Job Termination 
Operation: This routine, a part of the master subsystem, 
is a dummy routine. It replaces the normal job 


termination function when the job being terminated is a 
subsystem. 
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Entry from: A system routine via the IEFSSREQ 
macro. 


Exit to: The system routine. 
IEFJRASP — Common Request Router 


Operation: This routine, a part of the master subsystem, 
handles requests that require processing for all active 
subsystems except the master subsystem. 


Entry from: A system routine via the subsystem 
interface. 


Exit to: The system routine. 
IEFJREAD — Pseudo Access Method Sequential Read 


Operation: This routine, a part of the master subsystem, 
moves a record from a chain of records to a buffer and 
prepares for the next record to be read from the chain. 


Entry from: The converter or interpreter via the 
RPL/ACB interface. 


Exit to: Caller. 
IEFJRECF — Subsystem Interface Resource Manager 


IEFJRECF is a secondary entry point of IEFJRECM. 
See the IEFTRECM module description. 


IEFJRECM — Subsystem Interface Resource Manager 


Operation: This module checks the resource manager 
parameter list for task or address space termination 
indicators. It then builds either a task or address space 
SSOB extension. If an address space is terminating, it 
also builds a list of jobnames associated with the 
terminating address space. It then issues the 
IEFSSREO macro to communicate end-of-task or 
end-of-address space to all active subsystems. 


RTM enters this module at secondary entry point 
IEFJRECF to notify all active subsystems of an 
end-of-task. At this entry point, the module builds the 
end-of-task SSOB extension and issues IEFSSREQ _ 
macro. IEFJRECF is located before IEFJRECM in 
RTM’s list of end-of-task resource managers. 


Entry from: 


For entry point IEFJRECM: RTM using the 
address in the JESRECM field of the JESCT. 
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For entry point IEFJRECF: RTM using the 
address in the JESRECF field of the JESCT. 


Exit to. RTM. 
IEFJSBLD — Subsystem Service Routine 


See OS/VS2 System Initialization Logic for a module 
description of IEFJSBLD. 


IEF JSIMM — Subsystem Initialization and Parmlib 
Messages 


Operation: This module contains messages for 
subsystem initialization and parmlib processing. These 
messages are accessed and issued by IEFJSIMW. 
Entry from: None. 

Exit to: None. 

IEFJSDTN — Subsystem Determination 


Operation: This routine, a part of the master subsystem, 
determines if the task being started is a subsystem. 


Entry from: The initiator via the subsystem interface. 
Exit to: Return to the initiator. 


IEF JSIMW — Subsystem Initialization and Pannlib 
Processing Message Writer 


Operation: This module issues messages, which are 
contained in IEFJSIMM. It issues these messages 
during subsystem initialization (for IEFJSBLD and 
IEFJSIN2) and during the processing of the SET MPF 
command (for IEECB805). 


Entry from: TEECB805 and modules used during 
subsystem initialization (IEFJSBLD and IEFJSIN2). 
(See OS/VS2 System Initialization Logic.) 

Exit to: Caller. 

IEFJSINT — Subsystem Interface Initialization 


See OS/VS2 System Initialization Logic for a module 
description of IEFJSINT. 


IEF JSIN2 — Subsystem Initialization 


See OS/VS2 System Initialization Logic for a module 
description of IEFJSIN2. 


IEFJSREQ — Subsystem Interface 

Operation: IEFJSREQ handles requests for subsystem 
interface services from the IEFSSREQ macro. It 
determines which routine of which subsystem is to 


receive control and then passes control to that routine 
via a branch instruction. 


Entry from: A system routine via the IEFSSREQ 
macro. 


Exit to: The subsystem routine to perform the requested 
function. (See the figure “Subsystem Interface 
Summary,” for the module names.) 

Error exit. Caller with nonzero return code. 

IEFJSVEC — Subsystem Vector Table Service 
Operation: This module prevides an interface for calling 
the subsystem service routine (IEFJSBLD) which 
creates a subsystem vector table (SSVT) or modifies an 
existing one. 

Entry from: Any subsystem. 

Exit to: Caller. 

IEFJSWT — STC Write JCL Routine 


Operation: This module writes the internal JCL text for 
a START, MOUNT, or LOGON command. 


Entry from: TEESB605 via BALR. 

Exit to: Caller via branch. 

IEF JWRTE — Pseudo Access Method Sequential Write 
Operation: This routine, a part of the master subsystem, 
adds a record to a chain of records by obtaining 
storage, moving the new record to that storage area, 
and chaining the previous record to the new one. 

Entry from: The converter via the RPL/ACB interface. 
Exit to: The converter. 

IEFJWTOM — Subsystem Initiation Message Writer 
Operation: This routine, a part of the master subsystem, 
writes a hard copy of the converter, interpreter, and 
allocation error messages (including the JCL card 


images in error) for tasks being started via the master 
subsystem. 
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Entry from: The converter, interpreter, or allocation via 
the RPL/ACB interface. 


Exit to: Caller. 


IEFNB901 — Data Management Interpreter Exit 
Routine 


Operation: This module builds a parameter list for the 
data management interpreter routine and then passes 
control to that module which processes the AMP 
keyword parameter. 

Entry from: From IEFVDA via branch. 


Exit to: Data management interpreter routine via 
LOAD and BALR, caller via branch. 


IEFNB903 — Interpreter Initialization Routine 
Operation: This routine obtains storage for and partially 
initializes the interpreter work area (IWA), its I/O 
buffer, the JMR, and the DSENQ table. It also 
establishes an ESTAE environment for the interpreter. 


Entry from: TEFIB600 via LINK. 


Exit to: TEFVHE via branch or to the journal write 
routine via branch for restarted jobs. 


TEFQBS550 — SWA Manager Move Mode Functions 


Operation: This module assigns, writes, reads, or deletes 
scheduler work area (SWA) blocks in move mode. 


Entry from: Initiator/terminator, scheduler restart, 
converter/interpreter, IEFQB580 or IEFQB585. 


Exit to: Caller via branch. 
TEFQB555 — SWA Manager Locate Mode Functions 


Operation: This module assigns, writes, reads, or deletes 
scheduler work area (SWA) blocks in locate mode. 


Entry from: Initiator/terminator or scheduler restart or 
allocation or the scheduler JCL facility via SWAREQ 
macro instruction. 


Exit to: Caller via branch. 
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TEFQBS80 — QMNGRIO Macro Interface Handler 


Operation: This module provides an interface to SWA 
manager functions from data management routines that 
use the QMNGRIO macro instruction. IEFQB580 
builds and initializes a queue management parameter 
area (QMPA) for the module requesting SWA manager 
functions. 


Entry from: Data management routines via QMNGRIO 
macro instruction. 


Exit to. TEFQB550 via BALR. 
IEFQBS85 — SWA Manager Interface Module 


Operation: This module intercepts any references to 
previously existing queue manager modules. 
IEFQBS585 inserts the appropriate function code in the 
queue management parameter area (QMPA) on behalf 
of the requesting module. 


Entry from: Modules that reference previously existing 
queue manager modules. 


Exit to: TEFQB550 via BALR. 


IEFQMWR — Allocation/Termination Communication 
Area 


Operation: This non-executable CSECT contains the 
address of the nucleus-resident update DDR count 
routine (IEFAB438) and a pointer to the first MVCA 
on the MVCA chain. This area is called the 
allocation/termination communication area (ATCA) 
and is mapped by macro IEFZB432. 

Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFRPREP — Restart Preparation Routine 


Operation: This module determines if an ABENDed 
jobstep task can be restarted. 


Entry from: EFBB410. 


Exit to: TEFBB410. 


Licensed Material — Property of IBM 


IEFSDPPT — Program Properties Table 


IEFSD060 (IEFSD160) — Initiator Control 
Initialization 


Operation: This module builds the linkage control block 
(LCT) for a jobstep/task to be processed by the 
initiator and a STAE parameter list (STEPL) for the 
initiator’s STAE exit routine. 


Entry from. TEESB605 via LINK for LOGON, START, 
and MOUNT commands; IEFIIC via branch for 
normal initiator processing; IEEVIPL via ATTACH for 
master scheduler initialization. 


Exit to. TEFSD061 via branch. 
IEFSD061 (IEFSD161) — Job Select Routine 


Operation. This routine requests jobs for the initiator 
from the job entry subsystem and begins STOP 
processing as required for started tasks. 


For a selected job to be warmstarted, IEFSD061 sets 
up for warmstart processing; for all other selected jobs 
this module assigns special protect keys and processes 
data set integrity, if required. 


Entry from: YEFSD160 via branch for job selection or 
from IEFSD166 for job selection or stop processing. 


Exit to: A generalized initiator exit via branch, LINK, 
or XCTL for internal stop processing; to IEFSD164 via 
branch for warmstart; to IEFSD101 for normal 
initiator processing. 


IEFSD062 (IEFSD162) — Device Allocation Interface 
Routine 


Operation: This module invokes device allocation for a 
jobstep/started task, opens a JOBLIB, STEPLIB, or 
FETCHLIB required by the jobstep/started task, and 
completes assignments of special properties. 


Entry from: TEFSD102 via branch. 


Exit to: IEFSD103 via BALR, to IEFSD164 via BALR 
if an error occurred during allocation or OPEN catalog 
processing. 


JEFSD064 (IEFSD164) — Step Delete Routine 
Operation: When a jobstep/task completes processing, 


this module closes the JOBLIB, STEPLIB, or 
FETCHLIB DCBs, performs job and jobstep timing 


calculations, and builds a dummy TCB to be used by 
termination routines. 


Entry from. TEFSD161 via branch for warmstarted 
jobs; IEFSD162 via branch when an error occurs in 
allocation for a jobstep/started task; TEFSD263 via 
branch when a jobstep/started task completes 
processing; IEFIB621 to retry after ESTAE processing. 


Exit to: TEFSD101 via branch to initiate the next step 
in a job; IEFSD166 via branch to delete a job when all 
jobsteps have completed or to suspend a job, if 
necessary. 

IEFSD066 (IEFSD166) — Job Delete Routine 
Operation: This module deletes a job and its associated 
control blocks when the job completes processing or 
re-enqueues a job when necessary. 

Entry from: TEFSD164 via branch. 

Exit to: TEFSD161 via branch. 

IEFSD101 — PPT Scan 

Operation: This routine scans the program properties 
table (PPT) and assigns special properties to a 
jobstep/started task as indicated; it also builds a 
GETPART work table if one is required by the 
jobstep/started task. 

Entry from: IEFSD161 via branch for the first jobstep 
in job and from IEFSD164 via branch for subsequent 
jobsteps. 

Exit to: TEFSD102 via branch. 

IEFSD102 — Data Set Enqueue 


Operation. This routine enqueues on the data sets 
required for an entire job. 


Entry from: IEFSD101 via branch. 
Exit to: TEFSD162 via branch. 
IEFSD103 — ATTACH Interface Routine 


Operation. This module builds the ATTACH parameter 
list. 


Entry from: TEFSD162 via branch. 


Exit to. TEFSD263 via branch. 
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IEFSD160 — See IEFSD060 

JEFSD161 — See IEFSD061 

IEFSD162 — See IEFSD062 

IEFSD164 — See IEFSD064 

IEFSD263 — Initiator ATTACH Module 

Operation: This module gets a region for a 
jobstep/started task, if one is required, attaches the 
jobstep/started task, and then waits for an end-of-task 
or cancel ECB to be posted. When the appropriate 
ECBs are posted, this module detaches the 
jobstep/started task. 

Entry from: TEFSD103 via branch. 

Exit to: TEFSD164 via branch. 


IEFSJBLD — Scheduler JCL Facility Build SWB 
Routine 


Operation. This module builds a scheduler work block 
(SWB). 


Callers: TEFSTWRT. 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 
Entry Point BLDRETRY: This routine performs clean 
up processing when an ABEND occurs during SJF 
build processing. 
Callers: Recovery termination manager (RTM). 
Exit-Normat: None. 


Exit-Error. Return to the caller. 


External References: SWA manager locate mode 
(IEFQB555) and an alternate SWA manager routine. 


IEFSJCNL — Scheduler JCL Facility (SJF) Control 
Routine 


Operation: This routine is the entry point for all 
scheduler JCL facility (SJF) requests. It performs 
common initial processing for the SJF function, routes 
the request to the specified SJF function, and upon 
return, performs common clean up processing. 
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Callers: Any routine issuing the SJF request macro 
(SJFREQ). 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 


Entry Point RECOVERY: This routine is used to 
recover from an error that caused the exit to RTM. 


Callers: RTM. 


Exit-Normal: Returns to the mainline clean up 
processing if the ABEND occurred while SJF was 
processing a request. 


Exit-Error. Percolates to the caller’s recovery 
routine if the ABEND did not occur while SJF 
was processing or if a previous ABEND occurred. 


Entry Point RECCLEAN: This routine performs clean 
up processing when an ABEND occurs during the SJF 
control routine’s processing. 

Callers: RTM. 

Exit-Normal. None. 

Exit-Error. Return to the caller. 
External References: TEFSJDEF, IEFSJDEL, 
IEFSJEXT, IEFSJFND, IEFSJGET, IEFSJINT, 
IEFSJJDV, IEFSJPUT, IEFSJRET, IEFSJUPD, and 
IEFSJWRT. 


IEFSJDEF — Scheduler JCL Facility Define JDVT 
Routine 


Operation: This routine creates a JCL definition vector 
table (IDVT) and adds this table to the JDVT chain 
anchored off the JES control table (TESCT). 
Callers: TEFSICNL and IEFSJINT. 
Exit-Normal: Return to the caller. 
Exit-Error: Return to the caller. 
Entry Point DEFRETR Y: This routine performs clean up 
processing when an ABEND occurs during SJF define 
JDVT processing. 

Callers: RTM. 


Exit-Normat: None. 
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Exit-Error. Return to RTM. 
External References: No routines. 


IEFSJDEL — Scheduler JCL Facility Delete SWB 
Chain Routine 


Operation: This routine deletes a scheduler work block 
(SWB) chain. 


Callers: IEFSJCNL and IEFSJUPD. 
Exit-Normal: Return to the caller. 
Exit-Error: Return to the caller. 
Entry Point DELRETRY: This routine performs clean 
up processing when an ABEND occurs during SJF 
delete processing. 

Callers: RTM. 

Exit-Normal: None. 


Exit-Errer. Return to the caller. 


External References: SWA manager and the journal 
write routine (IEFXB500). 


IEFSJEXT — Scheduler JCL Facility (SJF) Extract 
Routine 


Operation: This routine extracts information from the 
JCL definition table (JDT) associated with a verb, a 
verb and keyword, a verb and key, or subparameters of 
a keyword or key. 
Callers: TEFSJCNL, IEFSJUPD, and IEFSJRET. 
Exit-Normal: Return to caller. 
Exit-Error. Return to caller. 
Entry Point EXTRETRY: This routine performs clean up 
processing when an ABEND occurs during the SJF 
extract routine’s processing. 

Callers: RTM. 

Exit-Normal: None. 

Exit-Errer: Return to the caller. 


External References: TEFSJJDV. 


IEFSJFND — Scheduler JCL Facility Find SWB Chain 
Routine 


Operation: This routine locates a scheduler work block 
(SWB) chain at a particular level of the scheduler work 
area (SWA) structure. 
Callers. TEFSJCNL and IEFSJUPD. 
Exit-Normal: Return to the caller. 
Exit-Error: Return to the caller. 
Entry Point FNDRETRY: This routine performs clean 
up processing when an ABEND occurs during SJF find 
SWB processing. 

Callers: RTM. 

Exit-Normal: None. 

Exif-Error. Return to the caller. 
External References: No routines. 


IEFSJGET — Scheduler JCL Facility Get SWB Chain 
Routine. 


Operation: This routine copies selected keywords from 
a SWB chain in text unit format into a storage area 
specified by the caller. The keywords obtained are 
those whose JDT flags match the qualifier flags set in 
the input parameter list. 
Callers: TEFSICNL. 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 
Entry Point GETRETRY: This routine performs clean up 
processing when a ABEND occurs during SJF get 
processing. 

Callers: RTM. 

Exit-Normal: Return to the caller. 

Exit-Error: Return to the caller. 


External References: TEFSJJDV and IEFSJRET. 
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IEFSJINT — Scheduler JCL Facility JDVT Initialization 
Routine 


Operation: This routine builds the system default JCL 
definition vector table. 


Callers: IEFSJCNL. 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 
Entry Point INTRETRY: This routine performs clean up 
processing when an ABEND occurs during SJF JDOVT 
initialization processing. 

Callers. RTM. 

Exit-Normal: None. 

Exit-Error: Return to the caller. 


External References: TEFSJDEF and IEFJSIMW. 


IEFSJJDV —— Scheduler JCL Facility (SJF) Find JDVT 
Routine 


Operation: This routine locates a JCL definition vector 
table (JDVT). 


Callers: TEFSJCNL, IEFSJEXT and IEFSJGET. 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 
Entry Point JDVRETRY: This routine performs clean up 
processing when an ABEND occurs during SJF find 
JDVT processing. 

Callers: RTM. 

Exit-Normal. None. 

Exit-Error. Return to the caller. 
External References: No routines. 


IEFSJPUT — Scheduler JCL Facility Put SWB Routine 


Operation: This routine rebuilds a SWB chain from 
SWB keyword data found in text unit format. 


Callers: TEFSJCNL. 
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Exit-Normat: Return to caller. 
Exit-Error. Return to caller. 
Entry Point PUTRETRY: This routine performs clean up 
processing when an ABEND occurs during SJF put 
processing. 

Callers. RT™.. 

Exit-Normat: None. 

Exit-Error. Return to the caller. 


External References: TEFSJUPD and IEFSJWRT. 


IEFSJRET — Scheduler JCL Facility (SJF) Retrieve 
Routine 


Operation: This routine retrieves parameter information 
from a scheduler work block (SWB) chain associated 
with a keyword or keywords for a particular verb and 
label, and uses that information to build text units. 
Callers: TEFSICNL and IEFSJGET. 
Exit-Normal: Return to the caller. 
Exit-Error. Return to the caller. 
Entry Point RETRETRY: This routine performs clean up 
processing when an ABEND occurs during SJF retrieve 
processing. 

Callers: RTM. 

Exit-Normal: None 

Exit-Error: Return to the caller. 


External References: TEFSJEXT. 


IEFSJUPD — Scheduler JCL Facility (SJF) Update 
Routine 


Operation: This routine verifies the text units specified 
by the caller and if requested, updates the SWB chain 
with the information specified in text unit format. 
Callers: TEFSJCNL and IEFSJPUT. 

Exit-Normal: Return to the caller. 


Exit-Error. Return to the caller. 
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Entry Point UPDRETRY: This routine performs clean 
up processing when an ABEND occurs during the SJF 
update routine’s processing. 

Callers: RTM. 

Exit-Normal: None. 


Exit-Error. Return to the caller. 


External References: TEFSJIDEL, IEFSJEXT, 
IEFSJFND, IEFSJWRT, and IEFXB500. 


IEFSJWRT — Scheduler JCL Facility (SJF) Write 
SWB Routine 


Operation: This routine locates a specific SWB and 
updates its data portion. 


Callers: TEFSJCNL, IEFSJUPD, and IEFSJPUT. 
Exit-Normal: Return to the caller. 
Exit-Error: Return to the caller. 
Entry Point WRTRETRY: This routine performs clean 
up processing when a ABEND occurs during SJF write 
processing. 

Callers: RTM. 

Exit-Normat: None. 

Exit-Error. Return to the caller. 
External References: TEFSJBLD. 
IEFSMFIE — SMF Initialization Exit Support Module 
Operation: This module constructs a timing control 
table (TCT) and supports user’s job initiation exit 
routines and step initiation exit routines. It also issues 
SMF job commencement record type 20 and/or type 
30. 
Entry from: TEFSD101 via BALR. 
Exit to: TEFSD101 via branch. 


Called routines: TEFUSI, IEFUJI, IEFSMF30, and 
TEFSMF32. 


IEFSMF30 — Type 30 Setup Record for SMF 


Operation. This module builds the model for type 30 
SMF records. IEFSMFIE calls the module at job start; 
IEFTB721 calls it at step termination if a warm start 
occurred and previous records were lost. 


Entry from: TEFSMFIE and IEFTB721. 

Exit to: Caller. 

IEFSMF32 — Type 32 Record Setup for SMF 
Operation: This module is called at job start by 
IEFSMFIE to build the model for type 32 SMF 
records. 

Entry from: TEFSMFIE. 

Exit to: Caller. 

IEFTB721 — SME Job and Step Termination Processor 
Operation: This module provides the user with job and 
step information after the job or step completes. The 
module contains an ESTAE routine to maintain control 
block integrity should a user error occur in the user 
exit, IEFACTRT. 

Entry from. TEFSD263. 

Exit to: Caller. 


Called routines: TEFTB722, IEFSMF30, IEFTB727, 
IEFTB726, IEFACTRT. 


IEFTB722 — SMF Job and Step Termination Record 
Assembler — 


Operation: This module assembles job and step 
information into an SMF record format (type 4, 5, 34, 
or 35) after the job or step completes. 


Entry from: TEFTB721. 
Exit to: Caller. 


IEFTB723 — SMF Exit Write-to-Programmer 
Processor 


Operation: This module provides an interface that can 
be used by IEFACTRT accounting exits to issue 
messages to the programmer. 
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Entry from: May be called via BALR from IEFACTRT. 
(IEFYS is an alternate entry name for IEFTB723). 


Exit to: TEFACTRT via branch. 
IEFTB726 — Type 30 SMF Record Builder 


Operation: This module builds a type 30 SMF record at 
step end. 


Entry from: TEFTB721. 

Exit to: Caller. 

Caller routines: TEFTB728. 

IEFTB727 — Type 32 SMF Record Builder 


Operation: This module builds and writes the step type 
32 record at step end or interval expiration. 


Entry from: TEFTB721 and IEEMB836. 

Exit to: Caller. 

JEFTB728 — Delta Type 30 SMF Record Builder 
Operation. This module builds a type 30 SMF record 
which contains data representing changes made since 
the last record or step start, whichever is later. 

Entry from: TEEMB836 and IEFTB726. 

Exit to: Caller. 

IEFUJI — User Job Initiation Exit Routine 


IEFUJV — Converter/Interpreter SMF User Exit 
Routine 


IEFUSI — User Step Initiation Exit Routine 

IEFUTL — User Time Limit Exit Routine 

IEFVDA — Interpreter DD Card Processor 

Operation: This routine creates and initializes the 
control blocks for a DD statement. It also checks the 
validity of DD keyword values and then sets a job fail 
indicator if it finds an invalid keyword value. 


Entry from: TEFVHE via branch. 


Exit to: TEFVHE via branch. 
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IEFVDBSD — Interpreter DSENQ Table Processor 


Operation: This module creates a DSENQ table for all 
explicitly named (by DSNAME parameter) data sets 
and marks each as exclusive or shared. 


Entry from: TEFVDA or IEFVEA via branch. 
Exit to: Caller via branch. 
IEFVEA — Interpreter EXEC Statement Processor 


Operation: This routine creates a step control table 
(SCT) for an EXEC statement and the override and 
refer-back tables required for the step. It also chains 
the SIOTs and JFCBs for a job library, job catalog, 
and/or concatenation of data sets for the step. 


Entry from: TEFVHE via branch. 
Exit to: Caller via branch. 
IEFVFA — Converter Scan Routine 


Operation: This module scans the JCL card images for 
syntax errors and merges JCL from the JCL data set 
and a cataloged or in-stream procedure if required. It 
then converts each JCL statement into internal JCL 
text. 


Entry from: TIEFVHEB via branch. 

Exit to: TEVHF via branch. 

IEFVFB — Converter Symbolic Parameter Routine 
Operation: This module assigns values specified on an 
EXEC procedure statement or PROC statement to 
symbolic parameters that appear on JCL statements in 
cataloged or in-stream procedures. 

Entry from: TEFVFA via BALR. 


Exit to: Caller via branch. 


JEFVGK — Interpreter GET Key/Positional Utility 
Routine 


Operation: This routine sets a pointer to the next JCL 
keyword or positional parameter in the internal text 
buffer for the JCL statement processor routines, 
IEFVJA, IEFVEA, IEFVDA, or IEF VJDTI. 
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Entry from: TEFVJA via branch, or from IEFVEA via 
branch, or from IEFVDA via branch, or from 
IEFVJDTV via branch. 

Exit to: Caller via branch. 

IEFVGM — Converter/Interpreter Message Module 


Operation: This module puts error messages for the 
entire converter/interpreter into the message data set, 


and/or any required JCL statements to the list data set. 


Entry from: IEFVJA via branch, or from IEFVEA via 
branch, or from IEFVDA via branch, or from 
IEFVJDTV via branch, or from IEFVJDTI via branch. 


Exit to: Caller via branch. 
IEFVGT — Converter Test and Store Utility Routine 


Operation: This module performs miscellaneous 
functions for the JCL statement processors, IEFVJA, 
IEFVEA, and IEFVDA, based on indicators in the 
parameter descriptor table passed to it by the processor 
— routines. 


Entry from: TEFVJA, IEFVEA, or IEFVDA via branch. 


Exit to: Caller via branch. 
JIEFVHA — Converter GET Routine 


Operation: This module reads into an input buffer JCL 
statements from the JCL data set, from the procedure 
library, and/or from in-stream procedures. 


Entry from: IEFVHC or IEFVIND via branch. 
Exit to: TEFVHC via branch. 


IEFVHC — Converter Comment or Continuation 
Validation Routine 


Operation: This routine determines whether a valid 
comment or continuation is indicated on a JCL 
statement. 


Entry from: TEFVHA via branch. 


Exit to: to IEF VHEB via branch, if a continuation was 
expected and was or was not received; to IEFVHA via 
branch, if a comment was received; to IEFVHCB, via 

branch, if no continuation was expected. 


IEFVHCB — Converter Verb Identifier Routine 


Operation: This routine identifies the verb on a JCL 
statement and merges JCL statements from the JCL 
data set and the procedure library. 


Entry from: TEFVHC, IEFVHL, or IEFVHF via 
branch. 


Exit to. TIEFVHA, via branch, when the JCL statement 
does not contain a verb; to IEFVHA, via branch, when 
the procedure library buffer must be primed; to 
IEFVHEB, via branch, when the JCL statement 
contains a JOB, EXEC, DD, or NULL verb; to 
IEFVHM, via branch, when the verb is unrecognizable; 
to IEFVINA, via branch, when a PROC verb is found. 


IEFVHE — Interpreter GET and Route Routine 


Operation: This routine gets JCL text strings from the 
internal text data set and routes them to the 
appropriate processor. It also determines when the SCT 
for a step or the JCT for a job should be written into 
SWA. 


Entry from: TIEFNB903 via branch. 


Exit to: TIEFVJA via branch when a JOB statement text 
string is encountered; to IEFVEA via branch when an 
EXEC statement text string is encountered; to 
IEFVDA via branch when a DD statement text string is 
encountered; to IEFVJDTV when a JDT-defined 
statement text string is encountered; to IEFVHH when 
an SCT or JCT is to be written into SWA. 


IEFVHEB — Converter Pre-scan Routine 


Operation: This routine performs checkpoint/restart 
functions, enters JCL statements into the list data set, 
and initializes the JMR for SMF processing. 


Entry from: TEFVHC or IEFVHCB via branch. 


Exit to. When IEFVHEB is used as a subroutine, it 
returns to its caller via branch; when it has been used 
to initialize a JMR, or to process a SYSCHK DD 
statement or a PROC statement, it branches to 
IEFVEA. 


TIEFVHF — Converter Termination Routine 
Operation. This module frees storage space used by the 


converter, issues a terminate request for the scheduler 
JCL facility services, issues messages to the operator 
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about the status of the job after converter processing, 
initializes SYSCHK DD statement processing and 
deactivates the converter ESTAE environment. 


Entry from: IEF VFA via branch. 


Exit to: TEFVHA when continuation of JCL text is 
expected; [IEF VHCB when no continuation is expected 
or to continue SYSCHK DD processing; IEFVHEB if a 
procedure statement is being overridden. 


IEFVHH — Interpreter ENQUEUE Routine 


Operation: This module writes job and step tables into 
SWA as required and then performs miscellaneous 
clean-up processing for the interpreter. 


Entry from: YEFVHE via branch. 
Exit to: TEFVHN via branch. 


JEFVHL — Converter NULL Statement or 
END-OF-FILE Processor 


Operation: This routine performs end-of-file processing 
for JCL statements in the JCL data set or ina 
cataloged or in-stream procedure. 


_Entry from: TEFVHEB via branch. 


Exit to: TEFVHA, via branch, to continue reading a 
procedure; IEFVHEB, via branch to continue 
processing a JCL statement from a procedure; 
IEFVHCB, via branch, to continue reading JCL 
statements from the JCL data set; IEFVHF, via 
branch, when both the JCL data set and all procedures 
are completed. 


IEFVHM — Converter Command Verb Validation 
Routine 


Operation: This routine determines if a valid command 
has been specified on a JCL statement. 


Entry from: TEFVHCB via branch. 

Exit to: TIEFVHA via branch. 

IEFVHN — Interpreter Termination Routine 

Operation. This module frees storage space used by the 
interpreter, issues a terminate request for the scheduler 
JCL facility services, issues messages to the operator 
about job status at the end of interpreter processing, 


and deactivates the ESTAE environment over the 
interpreter. 
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Entry from: TEFVHH via branch. 


Exit to: The interpreter’s original caller, SWA create 
interface, IEFIB600, via branch. 


TEFVHQ — Converter SWA Manager Interface 


Operation: This routine is the interface between either 
the converter or interpreter and the SWA manager or 
between the interpreter and the journal merge routine. 


Entry from: TEFVDA, IEFVEA, IEFVFB, IEFVHA, 
IEFVHH, IEFVINA, or IEFVJA via branch. 


Exit to: Caller via branch. 


IEFVHR — Converter/Interpreter Operator Message 
Module 


Operation: This module puts converter and interpreter 
error messages for the operator into the message data 
set. 


Entry from: TEFVHA, IEFVHF, IEFVHM, or 
IEFVHN via branch. 


Exit to: Caller via branch if recovery is possible; to 
IEFVHN, via branch, if recovery is not possible. 


IEFVH1 — Converter Initialization Routine 


Operation: This routine performs initialization 
processing for the converter, obtains storage space for 
work areas and buffers, and establishes the ESTAE 
environment over the converter. 


Entry from: The job entry subsystem or the master 
subsystem. 


Exit to. TEFVHA via branch. 


IEFVINA — Converter In-stream Procedure Control 
and GTF Routine 


Operation: This module reads in-stream procedures 


from the JCL data set, records each procedure, and 


saves each one in compressed form in the scheduler 
work area (SWA). 


Entry from: TEFVHCB via branch. 
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Exit to. TEFVHA, via branch, for each successive 
statement in an in-stream procedure. 


IEFVINB — Converter In-stream Procedure Directory 
Search Routine 


Operation: This routine searches through the procedure 
directory for a procedure name specified on a JCL 
statement. When it locates the procedure name, it 
returns to the calling routine the address at which that 
procedure begins. 


Entry from: TEFVINA via branch. 
Exit to: Caller via branch. 


IEFVINC — Converter In-stream Procedure Directory 
Build Routine 


Operation: This module builds an entry for a specified 
procedure in the in-stream procedure directory. 


Entry from: TEFVINA via branch. 
Exit to: Caller via branch. 


IEFVIND — Converter In-stream Procedure Expand 
Interface Routine 


Operation: This module functions as an access method 
for IEFVHA. Whenever IEFVHA issues a READ 
macro instruction for a record from an in-stream 
procedure, IEFVIND sets up required parameter lists 
and then invokes IEZDCODE to expand the record. 


Entry from: TEFVHA via branch. 
Exit to: IEZDCODE, via branch, to expand a record; to 
IEF VHQ, via branch, to read another record; to caller, 


via branch, when processing has completed. 


IEFVINE — Converter In-stream Procedure Syntax 
Checker 


Operation: This routine checks the label field of a 
PROC or PEND statement appearing in an in-stream 
procedure. 


Entry from: IEFVINA via branch. 


Exit to: Caller via branch. 


IEFVJA — Interpreter JOB Statement Processor 
Operation: This module creates and initializes the 
control biocks and tables required by a JOB statement 
and also checks the validity of JOB statement keyword 
values. 

Entry from: Y1EFVHE via branch. 

Exit to: Caller via branch. 

IEFVJDTI — JDT-Defined JCL Interpreter 

Operation: This module interprets the JDT-defined JCL 
internal text and builds the associated scheduler work 
blocks (SWBs). 

Entry from: TEFVGK. 

Exit to: Caller. 

IEFVJDTV — JDT-Defined JCL Verb Processor 


Operation: This module processes the JDT-defined verb 
statements. 


Entry From: TEFVHE. 
Exit To: Caller. 


IEFVKMSG — Test EXEC Dependency Codes 
Message 


Operation: This module contains the message text of the 
message issued by IEFBB402, if a step is not run 
because of the COND parameter on the EXEC 
statement. 

Entry from: Not applicable (non-executable module). 
Exit to: Not applicable (non-executable module). 


Called routines: Not applicable (non-executable 
module). 


IEFXB500 — Journal Write Routine 


Operation: This module writes critical control blocks to 
the job journal for purposes of restart or termination. 


Entry from: SWA manager, initiator, VIO, and the 
scheduler JCL facility. 


Exit to: Caller. 
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IEFXB601 — Journal Merge Routine 


Operation: This module merges the control blocks from 
the job journal to the scheduler work area (SWA) to 
establish a pre-job failure-environment. 

Entry from: TEFTB605. 

Exit to: TEFIB605. 

IEFXB602 — Move Mode Restart Interface Routine 
Operation: This module builds a virtual address table 
(VAT) to be used when the journal merge routine 
reconstructs SWA. 

Entry from. TEFVHQ. 

Exit to: TEFVHQ. 


IEFXB603 — Automatic/Checkpoint Restart Message 
Module 


Operation: This module contains message texts for 
journal service and checkpoint routines. The module is 
non-executable. 


Entry from: TEFXB500, IEFRPREP, IEFXB609, 
TEFXB601. 


Exit to: Caller. 

IEFXB604 — Step Header Create 

Operation: Except for automatic step or automatic 
checkpoint restarts, this module builds the step header 
record for each job step, before putting anything else in 
the job journal for the step. 

Entry from: TIEFSD162. 

Exit to: TIEFSD162. 

IEFXB609 — Data Set Descriptor Record Processor 
Operation: This module makes the SWA entries for 
restarting jobs reflect the job environment at the time a 


checkpoint was issued. 


Entry from. TEFTB605. 
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Exit to: TEFIB605. 

IEFXB610 — Open Interface Module 

Operation: This routine opens the checkpoint data set. 
Entry from: TIEFXB609. 

Exit to: TEFXB609. 


IEFXB611 — Locate Mode Restart Interface 
Processing 


Operation: This module builds a virtual address table 
(VAT) for each SWB to be used when the journal 
merge routine reconstructs the SWA. 

Entry from: IEFSJWRT. 

Exit to. TEFSJWRT. 


IEFXVNSL — User-Replaceable Non-Standard Label 
Routine 


Operation: This user-replaceable module returns a code 
of 4 if it is called because no user non-standard label 
handling routine exists to process an NSL label volume. 
Entry from. TEFAB473. 

Exit to: Caller. 

Called routines: None. 

IEWSUOVR — Overlay Supervisor Resident Module 
Operation: This module performs overlay requests. 
Entry from: Overlay segment. 

Exit to: Overlay supervisor processor IEWSWOVR. 
IEWSWOVR — Overlay Supervisor Processor 


Operation: Performs the overlay request and causes 
segments to be brought into virtual storage. 


Entry from: Overlay supervisor resident module 
TIEWSUOVR. | 


Exit to: Overlay segment. 
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IEZDCODE — Interpreter In-stream Procedure 
Decompression Subroutine 


Operation: This module re-expands the in-stream 
procedure records that were compressed by 
IEZNCODE. 

Entry from: IEFVIND via branch. 

Exit to: Caller via branch. 


IEZNCODE — Interpreter In-stream Procedure 
Compression Subroutine 


Operation: This module compresses the data records 
that comprise an in-stream procedure by replacing 
blanks with count fields. It then blocks the compressed 
records. 

Entry from: IEFVINA via branch. 

Exit to: Caller via branch. 

IFAEASI — SMF System Address Space Processing 
Operation. This module, which is scheduled as an SRB, 
records SMF accounting data for system address spaces 


that do not go through full-function start. 


Entry from: SRB scheduler, scheduled by IFAINIT; 
IFAEASIL. 


Exit to: Caller. 

Called routines: TEEMB839 (SMF timer enqueue). 
IFAEASIL — SMF System Address Space Setup 
Operation: This module schedules an SRB to set up the 
SMF timer elements for address spaces that do not go 
through full-function start and are started after SMF 
initialization is complete. 

Entry from: TEEPRWI2. 

Exit to: Caller. 

Called routines: [FAEASI, IEEMB839. 


IFAINIT — SME System Address Space Processing 
Initialization 


_ Operation: This module is called during SMF 
initialization. It checks all address spaces and 
schedules an SRB to the system address spaces that 


have not gone through full function start. The SRB 
causes SMF accounting data to be recorded for the 
address space. 

Entry from: TEEMB823. 

Exit to: Caller. 

Called routines. TEFAEASI, IEEMB839. 


IFARPORT — SMF Summary Activity Report for 
IFASMFDP 


Operation: This module writes a summary report of 
records processed by IFASMFDP (the SMF dump 


program). 

Entry from. TFASMFDP. 

Exit to: Caller. 

IFASMFDP — SMF Data Set Dump Module 
Operation: This module parses input, supplies defaults, 
and lists resultant options. It dumps input data sets in 
response to the keyword DUMP and clears VSAM 
input data sets in response to keyword CLEAR. 
Entry from: Problem program. 

Exit to: Caller. 


Called routines: TEEMB832, IEEMB833, IEEMB824, 
IFARPORT via BALR. 


IGC0203E (IEEJB840) — Write-to-Programmer 
Operation: Process write-to-programmer requests 
(messages) for WTO and WTOR macro instructions 
with routing code 11. 

Entry from: TEAVVWTO. 

Exit to: EAVVWTO. 

IGCO08E — NSLREPOS Interface 

Operation: This module interfaces with the user written 
routine, NSLREPOS, to verify NSL tapes and to 


determine if re-positioning of the tape is required. 


Entry from: Supervisor call instruction (SVC) interrupt 
handler. 
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Secondary entry point: |GCO408E (return from user 
written routine, NSLREPOS). 


Exit to: Caller. 
Called routines. NSLREPOS (user written). 


IGE0660A — Error Recovery Procedures (ERP) 
Interface 


Operation: After a permanent disk or I/O error occurs, 
this module tests the existing conditions to determine 
whether DDR can be used to correct the error. If so, it 
schedules the DDR task. 


Entry from: Outboard recorder (OBR). 
Exit to: Dispatcher. 

Called routines: |GFDEO, IGFDV1. 
IGFCCHCR — CCH Central Routine 


Operation: This module creates error recovery 
procedure information blocks (ERPIBs) containing 
channel dependent information for the error recovery 
procedures (ERPs). IGFCCHCR allows an attempted 
recovery that would otherwise be a permanent I/O 
error. It creates a record for each channel error 
detected so that it may be recorded on 
SYS1.LOGREC. 


For entry IGFCCHAS: This routine formats and 
issues the CCH operator awareness message. It 
puts out the CCH LOGREC record and the 
message asynchronously using the RECORD 
macro of RTM. 


For entry IGFCCHEX: This routine is the 
common exit from CCH, it determines whether the 
exit is to I/O supervisor (IOS) or to I/O restart. 


For entry IGFCCHFE: This routine completes the 
work ERPIB, determines the channel type from the 
channel availability table (CAT) and calls the 
appropriate channel dependent analysis routine. 


For entry IGFCCHER: This routine receives 
control from RTM to perform recovery from a 
program check by building the register update 
block. 


For entry IGFCCHIO: This routine handles errors 


for which CCH was unable to create the necessary 
error recovery procedure information block 
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(ERPIB). It schedules a retry by the ERPs, or posts 
the error as permanent. 


For entry IGFCCHMP: This routine fills in the 
multiprocessing portion of the CCH record. 


For entry IGFCCHRD: This routine creates the 
channel error record to be recorded on 
SYS1.LOGREC. 


For entry IGFCCHRV: This routine determines if 
the channel reconfiguration hardware (CRH) is 
active for the channel with the detected error. 


For entry IGFCCHUC: This routine searches the 
unit control block (UCB) for active devices on the 
channel indicating a channel failure. 


Entry from: {OS (IECIOSCN). 
Exit to: IOS. 


Called routines: |GFCIC, IGFC60, IGFC70, IGFC80, 
IGFPSADO, IGFPSAEO. 


IGFCCHED -— External Damage Type Machine Check 
Processor 


Operation: This module processes external damage type 
machine checks for the channel check handler. It 
analyzes all available channels as indicated in the 
channel availability table (CAT), and schedules the 
proper routine based on whether a lost channel 
condition occurred. 


Entry from. IGFPMSCA. 
Exit to: Caller. 


Called routines: Schedules IECVIRST or IECVRSTI, if 
lost channel(s) detected. 


IGFCIC — Integrated Channel Analysis Routine 


Operation: This module performs the dependent 
analysis for the integrated channels. It checks the 
validity of the limited channel logout (LCL) and sets 
indicators in the error recovery procedure information 
block (ERPIB). It also checks the I/O extended logout 
and saves the length and address for processing by the 
record entry build routine (IGFCCHRE). 


Entry from: IGFCCHCR. 


Exit to: Caller. 
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Called routines: None. 

IGFC60 — 2860 Channel Analysis Routine 

Operation: This module performs the channel 
dependent analysis for the 2860 channel. It sets 
indicators for validity bits, error conditions, termination 
codes, and sequence codes in the work error recovery 
procedure information block (ERPIB). 

Entry from: IGFCCHCR. 

Exit to: Caller. 

Called routines: None. 

IGFC70 — 2870 Channel Analysis Routine 

Operation. This module performs the channel 
dependent analysis for the 2870 channel. It sets 
indicators for validity bits, error conditions, termination 
codes, and sequence codes in the work error recovery 
procedure information block (ERPIB). 

Entry from: IGFCCHCR. 

Exit to: Caller. 

Called routines: None. 

IGFC80 — 2880 Channel Analysis Routine 

Operation: This module performs the channel 
dependent analysis for the 2880 channel. It sets 
indicators for validity bits, error conditions, termination 
codes, and sequence codes in the work error recovery 
procedure information block (ERPIB). 

Entry from: IGFCCHCR. 

Exit to: Caller. 

Called routines: None. 

IGFDD0 — DDR Disk Select 


Operation. This module processes a swap request for a 
disk device. 


Entry from: IGFDIO. 
Exit to: Caller. 


Called routines: IGFDEO, IGFDD1, IGFDVO, 
IGFDMO. 


IGFDD1 — DDR Disk Validate 


Operation: This module validates the disk devices 
involved in a disk swap. 


Entry from: IGFDDO0, IGE0660A, IGFDVO. 
Exit to: Caller. 
Called routines. IGFDV1, IGFDEO. 


IGFDE0 — DDR Extended Specify Task Abnormal Exit 
(ESTAE) Controller 


Operation: This module establishes or removes the error 
recovery.environment for DDR. 


Entry from: IGF2503D, IGFDD0, IGFDVO, 
IGE0660A, IGFDTO, IGFDS1, IGFDUO, IGFDIO, 
IGFDI1. 


Exit to: Caller. 
Called routines: None. 


IGFDE1 — Extended Specify Task Abnormal Exit 
(ESTAE) Handler 


Operation: This module releases the dynamically 
allocated storage and allocated resources of a module 
that has experienced an error. It also determines for 
the recovery termination manager whether a retry 
attempt should be made. 


Entry from: Recovery termination manager. 
Exit to: Caller. 


Called routines: IGFPxxS, if this special exit routine 
exists. 


IGFDIO — DDR Initiator 


Operation: This module controls processing of the DDR 
queues. It locates a request for device swap, calls the 
appropriate routine to handle it, removes it from the 
queue, and repeats this process until the queue is 
empty. IGFDIO also controls the repositioning of a 
tape volume for a tape swap. 


Entry from: Dispatcher, attached by IGFDS1. 


Exit to: Caller. 
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Called routines: |GFDU0, IGFDDO, IGFDTO, IGFDI]1, 
IGFDEO, IGFDT2. 


IGFDI1 — DDR Termination Module 

Operation: This module terminates processing of 
individual DDR requests and removes the DDR control 
block (DDRCOM) from the queue. It may also 
terminate the entire queue. 

Entry from: IGFDIO or IGFDEO. 

Exit to: Caller. 

Called routines: |GFDEO, IGFDMO, IGCO15. 

IGFDL1 — Candidate Lookup 

Operation. This module locates a compatible, on-line, 
unallocated device to be used in a system-initiated 
device swap. 

Entry from: IGFDVO. 

Exit to: Caller. 

Called routines. |GFDT1, IGFDD1, IGFDEO. 
IGFDMTXT — DDR Message Text Module 

Operation: This module contains the text segments used 
to build all messages issued by the DDR message writer 
(IGFDMO). 

Secondary entry point: |GFDMIND. 

Secondary entry point: IGFDTIND. 

Secondary entry point: IGFDIIND. 

Secondary entry point: IGFDHIND. 

Called routines: None. 

IGFDM0 — DDR Message Writer Routine 

Operation: This module issues a DDR message to 
inform the operator of the status of DDR, to prompt 
the operator for information necessary for the swap to 
continue, or to inform the operator of the status of the 


swap. 


Entry from: IGFDDO, IGFDTO, IGFDUO, IGFDVO. 
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Exit to: Caller. 
Called routines. IGFDEO. 
IGFDM1 — DDR I/O Module 


Operation: This module performs all DDR I/O, except 
writing console messages. 


Entry from: IGFDVO. 

Exit to: Caller. 

Called routines: |GFDEO. 
IGFDRO — DDR Recorder 


Operation. This module formats DDR LOGREC 
records and requests LOGREC recording. 


Entry from: IGFDVO. 

Exit to: Caller. 

Called routines: |GFDEO, IGFDM1. 

IGFDSO — DDR Service Request Block (SRB) Routine 
Operation: This module creates the DDR task. 


Entry from: Dispatcher, SRB scheduled by IGF2503D, 
IGE0660A, IGFDIO. 


Secondary entry point. DSOFRR, entered by the 
recovery termination management after abnormal 
termination occurs while IGFDSO is executing. 


Exit to: Caller. 


Called routines: Stage 1 exit effector, stage 2 exit 
effector, IGCO15. 


IGFDS1 — DDR Attacher 

Operation: This module issues an ATTACH macro 
instruction to give control to IGFDIO, the DDR 
initiator. 

Entry from: Dispatcher, created (IRB) by IGFDSO. 
Exit to: Caller. 


Called routines: |GFDEO, IGFDI1 (as ESTAE exit). 
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IGFDTO — DDR Tape Select Routine 


Operation: This module processes a swap request for a 
magnetic tape device. 


Entry from: IGFDIO. 
Exit to: Caller. 


Called routines: IGFDT1, IGFDVO, IGFDRO, 
IGFDMO, IGFDEO, IGFDV1. 


IGFDT1 — DDR Tape Validate Routine 


Operation: This module validates the tape device 
involved in a tape swap. 


Entry from: IGEQ660A, IGFDT0, IGFDVO. 
Exit to: Caller. 

Called routines: IGFDEO. 

IGFDU0 — DDR Unit Record Select 


Operation: This module processes a swap request for a 
unit record device. 


Entry from: IGFDIO. 

Exit to: Caller. 

Called routines: |GFDV0, IGFDEO, IGFDMO. 
IGFDU1 — DDR Unit Record Validate 


Operation: This module validates the unit record devices 
involved in a unit record swap. 


Entry from: IGFDU0, IGFDVO. 

Exit to: Caller. 

Called routines: IGFDV1, IGFDEO. 

IGFDV0 — DDR Common Select Routine 

Operation: This module locates an alternate device to 
replace the device on which a permanent error 
occurred, and then performs the device swap for DDR. 


Entry from: |GFDDO, IGFDTO0, IGFDUO. 


Exit to: Caller. 


Called routines: |GFDEO, IGFDMO, IGFDL1, 


IGFDRO, IGFDM1, IGFDD1, IGFDT1, IGFDU1, 


IGFDWO. 

IGFDV1 — DDR Device Independent Validate 
Operation: This module determines whether the devices 
involved in the DDR swap are valid and compatible, 
and whether IOS has purged the user’s swap request. 
Entry from: IGFDT0, IGFDD1, IGFDU1. 

Exit to: Caller. 

Called routines: |GFDEO, TIEEVDEV. 

IGFDW0 — DDR Unit Control Block (UCB) Swap 
Operation: This module swaps the physical unit control 
blocks of the failing and replacement devices by 
invoking the IOSGEN function of IOS. 

Entry from: IGFDVO. 

Exit to: Caller. 


Called routines: |GFDEO, IGFDRO, IGFDM1, 
IOSGEN. | 


IGFPEXIT — Machine Check Handler Exit Routine 
Operation: This module performs processor-related 
initialization functions when entered from IGFPINIT at 
system initialization time. It performs threshold 
analysis by interrogating the various machine-check 
threshold blocks when called by IGFPMRTM. 
Entry from: |IGFPMRTM, IGFPBUCR, IGFPEXI2. 
Exit to: Caller. 

Called routines: |GFOIMMM. 

IGFPKREF — Storage Key Refresh Routine 
Operation: This module provides an interface which 
enables a storage key to be refreshed. It allows 
continued system execution when a machine check 
occurs due to an uncorrected storage key error. 
Entry from: IEAVRCEF. 

Exit to: Caller. 


Called routines: I|GFPMFRS. 
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IGFPMCIH — Machine Check Interrupt Handler 


Operation: This module performs machine-check 
recursion analysis, saves the error environment, and 
routes control to the various error analysis subroutines. 


Entry from: Loading the machine check new PSW. 


Secondary entry point: IGFPMCE2: The 
model-dependent support routine, IGFOOMMM, 
returns to this entry point. 


Secondary entry point. |GFPMCPC: At this entry point 
the module intercepts program checks that occur while 
IGFPMCIH is executing. 


Secondary entry point: |GFPMCRI: The module uses 
this entry point when a restart interruption occurs while 
IGFPMCIH is executing. 


Exit to. '|GFPTERM for processor termination, 
IGFPMRTM to continue machine check processing. 


Called routines: |GFOOMMM, IGFPMHCA, 
IGFPMPFX, IGFPMKTA, IGFPMSCA, ICFBCFO00 at 
entry point ICFBDEOO. 


IGFPMHCA — Machine Check Handler Hard Machine 
Check Analysis 


Operation: This module analyzes the 
model-independent fixed logout area to determine if 
hard machine check conditions are present. If present, 
it sets indicators in the machine check error indicator 
area of the LOGREC buffer for subsequent analysis, 
and schedules message IGF971I or IGF972I. 


Entry from: IGFPMCIH. 
Exit to: Caller. 


Called routines: '|GFPMFRS, IGFPMTHA, 
IGFPMMSG. 


IGFPMFRS — Functional Recovery Routine Stacker 


Operation: This module allows machine check handler 
modules to establish and use internal recovery routines 
in an attempt to recover from a machine check, a 
program check, or a restart interruption that occurs 
while they are executing. 


Entry from: (GFPMPFX, IGFPMHCA, IGFPMKTA, 
IGFPMMSG, IGFPMTHA, IGFPMSCA, IGFPKREF. 
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Secondary entry point: |GFPMSUP: This entry point is 
used by the machine check handler super functional 
recovery routine. 


Exit to: Caller. 

Called routines: TEAVEABD. 

IGFPMKTA — Machine Check Clock Timer Analysis 
Operation: This module analyzes the 
model-independent fixed logout area to determine if 
clock and timer damage conditions are present. If it 
finds an error in the time-of-day (TOD) clock, clock 
comparator, processor timer, or interval timer, it sets an 
indicator in the machine check error indicator area of 
the LOGREC buffer. If processor timer, clock 
comparator, or TOD clock damage has occurred, this 
module calls IGFPMTHA to perform threshold 
analysis. 

Entry from: IGFPMCIH. 

Exit to: Caller. 

Called routines. IGFPMTHA, IGFPMERS. 


IGFPMMSG — Machine Check Handler Message 
Scheduler 


Operation: This module locates an available message 
buffer in the message buffer pool, and prepares it for 
subsequent processing by the machine check 
asynchronous message writer (IGFPWMSG). 

Entry from: |IGFPMHCA. 

Exit to: Caller. 

Called routines. |GFPMFRS. 

IGFPMPFX — Prefix Routine 

Operation: This module converts an absolute address to 
a real address for later use by EAVTRTH, which 
converts it to a virtual address. 

Entry from: |GFPMCIH. _ 

Exit to: Caller. 


Called routines: IGFPMFRS. 
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IGFPMRTM — Machine Check Handler Recovery 
Termination Management Interface 


Operation. This module prepares the error environment 
data record for subsequent recording on 
SYS1.LOGREC and links to the recovery termination 
manager (RTM) to recover the error condition. 


Entry from: \GFPMCIH. 
Exit to: IGFPEXIT. 
Called routines: TEAVTRTH (via CALLRTM). 


IGFPMSCA — Machine Check Handler Soft Machine 
Check Analysis 


Operation: This module analyzes the 
model-independent fixed logout area to determine if 
soft machine check conditions (system recovery 
condition, degradation error, or external damage) are 
present. If so, it sets indicators in the machine check 
error indicator area of the LOGREC buffer for 
subsequent analysis. If a system recovery condition, 
degradation error, or external damage is present, this 
module calls IGFPMTHA to perform threshold 
analysis. 


_ Entry from: IGFPMCIH. 
Exit to: Caller. 


Called routines: 1GFPMFRS, IGFPMTHA, 
IGFCCHED. 


IGFPMTHA — Machine Check Threshold Analysis 


Operation: This module counts recoverable storage 
retry and buffer errors on soft machine checks, and 
compares this count with the threshold values of 
IGFTHB. When the threshold is reached, it schedules 
an operator message. IGFPMTHA also analyzes the 
following hard machine checks: instruction processing 
damage, system damage, an invalid PSW or register, 
time-of-day clock damage, processor timer damage, 
and clock comparator damage. When the threshold is 
reached, this module informs the caller, which then 


invokes IGFPTERM to perform processor termination. 


Entry from: |GFPMSCA, IGFPMKTA, IGFPMHCA. 


Exit to: Caller. 


Called routines: 1GFPMMSG, IGFPMFRS. 
IGFPNRFH — Nucleus Page-in 

Operation. This module pages in a single unchanged 
nucleus page to refresh the area affected by an 
uncorrected storage error on that nucleus page. 
Entry from: Dispatcher. 

Exit to: Caller. 

Called routines: IEAVFP. 


IGFPTAIM — Machine Check Handler Alternate CPU 
Recovery Interface 


Operation: This module initiates alternate CPU 
recovery (ACR) by giving control to IEAVTACR. 


Entry from: IGFPTSIG, IGFPXMFA. 
Exit to: TEAVTACR. 


IGFPTCON — Machine Check Handler Console Write 
Routine 


Operation: This module informs the operator that the 
system is to be terminated. 


Entry from: IGFPTSIG. 
Exit to: Caller. 


IGFPTERM — Machine Check Handler Processor 
Termination 


Operation: This module performs either system 
termination or processor termination. If an 
unrecoverable machine check occurs, it puts the 
executing processor in a stop state. If system 
termination is requested, it puts all online processors in 
disabled wait states. 


Entry from: GFPMCIH, ICRMSG00, IEAVEPC, 
IEAVESPR, IEAVTACR, IEAVGMO00, IEA VNIPM. 


Exit to. TEEVSTOP, IGFPTSIG. 


Called routines: (GFPTSIG. 
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IGFPTREC — Machine Check Handler Emergency 
Recorder 


Operation: During system termination, this module 
attempts to write records in the SYS1.LOGREC data 
set. 

Entry from: IGFPTSIG. 

Exit to: Caller. 


IGFPTSIG — Emergency Signal External Second Level 
Interrupt Handler 


Operation: During processor termination, this module 
invokes alternate CPU recovery (ACR). During 
system termination, it invokes the emergency recorder 
and console writer routines, and puts the system in a 
disabled wait state. 

Entry from: 


IGFPTERM for processor or system termination 
initiated by the machine check handler, 


IGFPXMFA when a malfunction alert is received, 
IEAVEES when an emergency signal is received. 
Exit to: IGFPTAIM, IEAVEEXT, 


Called routines: |GFPTAIM, IGFPSADO, IGFPSAEO, 
IGFPTREC, IGFPTCON. 


IGFPXMFA — Malfunction Alert External Second 
Level Interrupt Handler 


Operation: This module handles the malfunction alert 
external interrupt received from the failing processor. 


Entry from: TEAVEEXT. 
Exit to: Caller. 
Called routines. 1GFPTSIG, IGFPTAIM. 


IGFPWMSG — Machine Check Handler Asynchronous 
Message Writer 

Operation: This module writes an operator message 
scheduled by the mainline machine check handler. It 
executes asynchronously to the mainline machine check 
handler and operates under the master scheduler task. 


Entry from: TEAVTRET. 
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Exit to: Caller. 

IGFTMCHK — Missing Interruption Handler 
Operation: This module establishes the disabled 
interruption exit (DIE) routine, which gains control at 
specified intervals to search for missing MIH 
conditions. IGFTMCHK records missing I/O 
interruptions on the SYS1.LOGREC data set, and 
informs the operator of all missing MIH conditions. 
Entry from: The dispatcher (IEAVEDSO). 

Exit to: The dispatcher (IEAVEDSO). 


IGFTMC00 — Missing Interruption Handler DIE 
Routine 


Operation: This module schedules an SRB which has an 
entry point (IGFTMC01) within this module: When 
entered at IGFTMC01, this module scans the UCBs 
for missing MIH conditions and informs IGFTMCHK 
when the scan is completed. 


Entry from: The timer second level interrupt handler 
(SLI). 


Secondary entry point: |GFTMC01 via an SRB. 


Called routines: Special exit routines, CVTOPTO1 and 
CVTQTEOO. 


Exit to: The SLIH when entered at IGFTMC00, the 
dispatcher when entered at IGFTMC0O1. 


IGFTMC01 — See IGFTMC00 
IGF2503D — SWAP Command Processor 


Operation: This module processes all MODE 
commands. 


Entry from: TEEQ403D. 
Exit to. TEEQ003D, IEE0S03D. 
IGF2603D — MODE Command Processor 


Operation: This module processes all MODE 
commands. 


Entry from: TEEQ403D. 


Exit to: Caller, EEO503D. 
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IGX00013 — MFSTART Mainline Processor 


Operation: Controls the initialization and termination of 
routines that perform RMF functions. 


Entry from: {1GCO00101. 
Exit to. T1GCO010I. 
IGX00014 — MFDATA SVC Mainline Processor 


Operation: Controls the operation of measurement 
gathering routines that operate once each interval. 


Entry from: 1GCO0010I1. 
Exit to: IGCOO10I. 
IGX00025 — TSO Command Counter Module 


Operation: This module accumulates, into the type 32 
record, data pertaining to specified TSO commands. 
The data collected is: | 


Number of times the command is used 
TCB time for the command 

SRB time for the command 

TPUTs for the command 

EXCPS for the command 
Transactions for the command 


Entry from: SVC FLIH. 
Exit to: Caller. 
IKJEES20 — SEND Command Message Module 


Operation: This module contains the messages for the 
SEND command processor. 


Entry from: TEEVSEND, IKJEES10, IKJEES40. 
Exit to: Caller. 
IKJEFLF — System-lInitiated Cancel Schedule Routine 


Operation: This module schedules an SRB routine and 
checks the validity of the input to this routine. 


Entry from: TEE3703D, TIOC routines. 


Exit to: Caller. 


IKJL4T00 — System-Initiated Cancel SRB Routine 


Operation: This module synchronizes events between 
TIOC, LOGON scheduler and its subtasks to provide 
orderly cancellation of a TSO user. 


Entry from. SRB dispatcher. 
Exit to: SRB dispatcher. 
IKJ5803D — SEND Command Scanner 


Operation. This routine scans the SEND command 
parameter. 


Entry from: TIEEO403D. 
Exit to. TEEO803D, TEE0503D. 
ILRACT — Activate VIO ASPCT Routine 


Operation: This routine builds a parameter list and calls 
ILRVSAMI to retrieve the saved VIO ASPCT from 
SYS1.STGINDEX. The new LGN is stored with the 
retrieved ASPCT base and the number of slots required 
to back this VIO data set is recalculated. 


Entry from: ILRGOS. 
Exit to: ILRGOS. 
ILRCMP — ASM I/O Completion 


Operation: This module consists of six major routines: 
the disabled interrupt exit (LRCMPDIJ), normal 
channel end appendage (ILRCMPNE), abnormal 
channel end appendage (ILRCMPABE), termination 
(ILRCMP), PCI exit (ILRCMPCI), and notification 
exit (ILRMCMPNT). 


These routines process the individual requests that are 
represented by the PCCW chained off the IORB. If the 
I/O is successful the AIAs are returned to page 
completion and the PCCWs freed. Bad slots will be 
recorded in a special buffer in SQA. 


If the error occurred before the end of the PCCW 
chain was reached, the remaining PCCWs will be 
retried. 
Entry from: 

For entry ILRCMPDI: IECIOSCN. 


For entry IERCMPAE: IECVPST (Post Status). 
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For entry ILRCMPNE: IECVPST. 


For entry ILRCMP: IECVPST or IEAVEDSO, for 
SRB scheduled by ILRCMPO01. 


For entry ILRCMPCI: IECIOSCN. 

For entry ILRCMPNT: IECIOSCN. 
Exit to: 

For entry IERCMPDI: IECIOSCN. 

For entry ILRCMPAE: IECVPST. 

For entry IEURCMPNE: IECVPST. 

For entry ILRCMP: IEAVEDSO. 

For entry ILRCMPCI: IECIOSCN. 

For entry IERCMPNT: IECIOSCN. 
ILRCMP01 — I/O Completion Recovery Routine 
Operation: This recovery routine will attempt to clean 
up whatever resources have been checkpointed in the 
ATA and force reprocessing for any requests not yet 
attempted. 
Entry from: EAVTRTS (RTM). 
Exit to: TEAVTRTS. 
ILRCMSRB — SRB Routine to Invoke ILRPAGCM 
Operation: This routine (running as an SRB) is 
scheduled by the ASM functional recovery routines 
(ILRCMP01, ILRDRV01, ILRIOFRR, and 
ILRSRBO1) to invoke LRPAGCM. RTM restrictions 
prohibit the ASM functional recovery routines from 
directly calling ILRPAGCM. 
Entry from. TEAVEDSO. 
Exit to: TEAVEDSO. 
ILRCPBLD — Channel Program Build Routine 


Operation: This routine builds a channel program, then 
starts the I/O operation with: 


e RESUME if the channel program is suspended 

e« Modify the currently running channel program to 
TIC to the new one just built 

« STARTIO if the channel program has ended 
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Entry from: ILRIODRV. 
Exit to: ILRIODRV. 


ILRDRV01 — Recovery Routine for ILRIODRV and 
ILRCPBLD 


Operation: This routine eliminates invalid or loop 
causing control blocks. It restores or reconstructs the 
environment so that the remaining I/O requests will be 
properly processed by LRIODRV and ILRCPBLD. 
Entry from: TEAVTRTS (RTM). 

Exit to: TEAVTRTS. 

ILRFMT00 — Format Routine for ASM 

Operation: This routine formats ASM and shared RSM 
control blocks contained in storage areas passed by the 
system dump-printing routine (AMDPRDMP). 

Entry from: AMDPRUIM. 

Exit to: Caller. 


ILRFMTCV — Common and VIO Areas Format 
Routine for ASM 


Operation: This routine has three entry points. 
ILRFMTC formats the page and external page tables. 
ILRFMTH formats RSMHD and its SPCT, ASMHD 
and its AIA chain, the private area page tables and 
external page tables. ERFMTV formats the LGVT 
and its associated control blocks. 

Entry from: ILRFMT00. 

Exit to: ILRFMT00. 

ILRFMTPG — Paging Format Routine for ASM 


Operation: This routine formats the PART, PCTs, 
PATs, and all other ASM paging-related control blocks. 


Entry from: ILRFMT00. 
Exit to: ILRFMT00. 
ILRFMTSW — Swap Format Routine for ASM 


Operation: This routine formats the SART, SPCT, 
SATs, and all other ASM swap-related control blocks. 
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Entry from: ILRFMTO0. 
Exit to: IRFMT00. 
ILRFRRO1 — ASM Recovery Service Routines 


Operation: This module contains service routines 
common to ASM recovery routines. There are three 
types of service routines: 1) queue verification routines 
that verify and correct ASM queues, 2) control block 
verification routines that verify ASM-related control 
blocks, and 3) ASM’s resource manager termination 
routine (parameter for the PURGEDQ macro). 


Entries: 


ILRPSRMT -—— Reschedule an SRB for 


ILRCMSRB, ILRSIO, ILREDRV, or ILRSWPDR. 


ILRVACE — To verify a potential ACE. 
ILRVACEQ — To verify a queue of ACEs. 


ILRVACQ2 — To verify and correct a queue of 
ACEs. 


ILRVAIA — To verify a potential AIA. 
ILRVAIAC — To verify a potential AIA/ACE. 


ILRVIORB — To verify a potential 
IORB-IOSB-SRB-SRB chain. 


ILRVLGE — To verify a potential LGE. 


ILRVLPRQ — To verify LGE process queue 
(LGEPROCQ). | 


ILRVPCB — To verify a potential PCB. 


ILRVPCBQ — To verify queue of PCBs 
(RSMLIOQ). 


ILRVPCCW — To verify a potential PCCW. 
ILRVPCWQ — To verify a queue of PCCWs. 
ILRVSCCW — To verify a potential SCCW. 
ILRVSCWQ — To verify a queue of SCCWs. 
ILRVSPAQ — To verify a queue of swap AIAs. 


ILRVSWTQ — To verify swap wait queue 
(SARWAITOQ). 


Entry from: 
For all entries except ILRPSRMT: ILRGOSO1, 
ILRCMP01, ILRSRBO1, ILRDRV01, ILRSWP01, 
ILRTERMR, ILRTMIO1, ILRIOFRR. 
For ILRPSRMT: IEAVEPDOQ. 
Exit to: 
For all entries except ILRPSRMT: Caller. 
For ILRPSRMT: JEAVEPDQ. 
ILRFRSLT — Free Slot Routine 
Operation: This routine frees slots or swap sets, as 
required by the caller, by resetting the appropriate PAT 
bit or SAT bit. 
Entries: 
ILRFRSLT — used by RSM to free slots. 
ILRFRSL1 — used by ASM to free slots. 
ILRFRSW1 — used by ASM to free swap sets. 
Entry from: 


For entry ILRFRSLT: IEAVRELS, IEAVAMSI 
(RSM routines). 


For entry ILRFRSL1: ILRIODRV, ILRDRVO1, 
ILRSAV, ILRTERMR, ILRTMRLG, ILRPOS. 


For entry LRFRSW1: ILRPAGCM, ILRSWAP, 
ILRTERMR. 


Exit to: Caller. 
ILRGOS — Group Operation Starter 


Operation: This module accepts the following group 
requests: Assign LGN, Save LG/LGN, Activate LG, 
and Release LG. Each request is attempted to be 
started immediately. If not started, it is queued for later 
processing. 


Secondary entry point. ILRFRELG): Dequeues and 
frees a LGE. 
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Entry from: 


For entry ILRGOS: Virtual Block Processor 
(VBP). 


For entry ILRFRELG: ILRGOS01 or ILRRLG. 
Exit to: Caller. 
ILRGOSO1 — Group Operators Recovery Routine 
Operation: This module serves as an ESTAE for save 
and activate requests and an FRR for release logical 
group and assign requests. It will only retry for 
record-only abends. For other errors, the resources will 
be freed and the error percolated to the recovery 
routine of the caller of ILRGOS. 
Entries: 

ILRGOSO1: Handle the release or assign errors. 

ILRCGOSE: Handle the save or activate errors. 
Entry from: 

For entry ILRGOSO1: IEAVTRTS (RTM). 

For entry ILRCGOSE: IEAVTAS1 (RTM). 
Exit to: Caller. 
ILRIODRV — ASM I/O Driver 


Operation: This module contains several entry points 
used by RSM and ASM to manipulate page data sets. 


Entry point ILRIODRV: General frame allocation 
(IEAVGFA) and ASM swap control (ILRSWAP) call 
this routine to initiate I/O operations for page data 
sets. 


Entry point ILREDRV: ASM I/O completion 
(ILRPAGCM) schedules this entry as an SRB to retry 
requests that were incorrectly completed or that could 
not be started because of insufficient PCCWs. 


Entry point ILRSWLIO: If LSQA swap out 
(ILRSLSQA) was called by page completion 
(ILRPAGCM), it schedules this entry as an SRB to 
start LSQA swapping. 


Entry point ILRSWAPO: If LSQA swap out was not 


invoked by page completion, it calls this entry point 
directly to start LSQA swapping. 
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Entry point ILRSWPIN: ASM swap control 
(ILRSWAP) calls this entry point to start stage 1 
swap-in processing. 


Entry point ILRVIODR: Page operations starter 


(ILRPOS) calls this entry point to start VIO paging 
requests that had been queued behind other work. 


Entry from: 
For entry ILRIODRV: IEAVGFA, ILRSWAP. 


For entry LREDRV: IEAVEDS0O (scheduled by 
ILRPAGCM). 


For entry ILRSWLIO: IEAVEDS0O (scheduled by 
ILRSLSQA). 


For entry IERSWAPO: ILRSLSQA. 
For entry ILRSWPIN: ILRSWAP. 
For entry IERVIODR: ILRPOS. 
Exit to: Caller. 
ILRIOFRR — ASM I/O Control Recovery Routine 
Operation: 
Entry ILRIOFRR: This routine is called by RTM 
anytime an error occurs during ASM’s swap 
processing, initial page processing, and page 
completion processing. The mainline of the routine 
is a router to the appropriate recovery routine or 
subroutine representing the ASM function in 


control at the time of the error. 


Entry ILRPOSO1: This routine attempts recovery 
for ILRPOS. 


Entry from: IEAVTRTS (RTM). 
Exit to: TEAVTRTS. 


ILRJTERM — ASM Job Termination Resource 
Manager 


Operation: 


Entry ILRJTERM: This routine will schedule 
asynchronous operations to deactivate any VIO 
data sets still active at job deletion time. The LGE 
queue is searched to locate these VIO data sets. 
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Entry ILRJTMO!1: This routine is the recovery 
routine for ILRJTERM. 


Entry from: 


For entry ILRJTERM: IEFSD166 (initiator job 
deletion module). 


For entry ILRJTMO01: IEAVTRTS (RTM). 
Exit to: Caller. 
ILRMSG00 — ASM Message Module 
Operation: Entries ILRMSG00 and ILRMSGSP: 


This routine writes messages concerning the status of 


page and swap data sets. It will terminate the system if _ 


the condition of these data sets makes it impossible for 
ASM to continue. 


Entry ILRMSG01: This routine is the recovery 
routine for the termination subroutine of 
ILRMSG0O. 

Entry from: 


For entry ILRMSG00: ILRCMP, ILRCMP01, 
ILRDRVO1, ILRIODRV, ILRSWP01. 


For entry ILRMSGSP: ILRTMIO0 (an ASM 
initialization routine). 


For entry ILKRMSGO1: IEAVTRTS (RTM). 
Exit to: 

For entries ILRMSG00 and ILRMSGSP: Caller, if 

the system is not to terminate. IGFPTERM if the 

system is to terminate. 

For entry ILRMSG01: IEAVTRTS. 
ILROPS00 — ASM Page or Swap Open Routine 
Operation: This routine is entered to locate, mount, and 
build I/O control blocks for a page or swap data set. 
At NIP time control blocks may be requested not to be 
built. After NIP time control blocks are always built. 
Entry from: ILRASRIM or ILRPGEXP. 


Exit to: Caller. 


ILRPAGCM — ASM Page I/O Completion 


Operation: This routine analyzes an input chain of 
AIAs, separates them, and places them onto internal 
queues for the page and VIO subroutine or the swap 
subroutine. Each subroutine processes its chain of 
AIAs. Successful AIAs are returned to 

RSM. Unsuccessful AIAs may be redriven. 


Entry from: ILRCMP or ILRCMSRB. 

Exit to: ILRCMP or ILRCMSRB. 

ILRPEX — ASM Pool Extender 

Operation: This routine attempts to extend the ASM 
virtual storage pool indicated (ACE, BWK or SWK). 
ASMVT pool controller information is used and 
updated. 

Entry from: Any ASM module using ILRGMA macro. 
Exit to: Caller. 

ILRPGEXP — Page and Swap Expansion Module 
Operation: This module dynamically adds page and 
swap data sets to the system when the PAGEADD 


operator command is issued. 


Entry ESTAER is the ESTAE routine for 
ILRPGEXP. 


Entry from: 
For entry ILRPGEXP: Attached by IEEVWAIT. 
For entry ESTAER: IEAVTAS1 (RTM). 

Exit to: Caller. 

ILRPOS — Page Operations Starter 

Operation: 
Entry ILRPOS: This routine receives a string of 
I/O requests or a single transfer page request. The 
proper page processing subroutine is called. 
Requests that cannot be started immediately are 


queued for later processing. 


Entry ILRESTRT: This routine starts AIAs (I/O 
requests) that are on the LGE process queue. 
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Entry ILRTRANS: This routine processes transfer 
page ACEs. 


Entry ILRTRPAG: This routine creates a transfer 
page ACE from the transfer page request (ACA). 


Entry from: 
For entry ILRPOS: ILRIODRV or ILRTRPAG. 
For entry ILRESTRT: ILRSRBC. 


For entry IERTRANS: ILRSRBC or internally by 
ILRPOS. 


For entry ILRTRPAG: IEAVAMSI (RSM). 
Exit to: Caller. 
ILRPREAD — ASM-Special I/O Driver Routine 


Operation: This routine is an I/O driver for ASM 
initialization and expansion. It builds channel programs 
and invokes IOS using the STARTIO macro to do the 
I/O. It contains normal channel end abnormal channel 
end appendages (both of which are null routines). It 
contains an I/O termination routine that posts the 
mainline when the I/O has completed and which 
releases the LOCAL lock obtained by IOS. 


Callers invoke this routine to build and execute one of 
the following channel programs: 


1. To read slots from the PLPA, common, or duplex | 
page data sets 


2. To write slots to the PLPA, common, or duplex 
page data sets 


3. To test the cache of a buffered paging device 
4. To reset the cache of a buffered paging device 


5. To obtain the address of the cache (control block) 
array element that corresponds to a specific 
buffered paging device 


This routine reads and writes the slots on the PLPA, 
common, and duplex page data sets in order to access 
the TPARTBLE (ILRTPARB), QSRCD and record-0 
timestamps. This information is needed to perform 
quick starts and warm starts. 


This routine test and resets the caches and obtains the 
addresses of cache array elements for ASM. ASM uses 
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these services when page or swap data sets reside on a 
buffered paging device. 


Entry from: 
For entry ILRPREAD: ILRPGEXP and ASM 
initialization modules (ILRASRIM, ILRQSRIT, 
ILRTMIOO). 


For entries PREADABN and PREADNRM: 
IECVPST (Post status). 


For entry PREADTRM: IECVPST. ! 
For entry ESTAEXIT: IEAVTAS1. 
Exit to: For entry IERPREAD: Caller. 


For entries PREADABN and PREADNRM: 
IECVPST. 


For entry PREADTRM: IEAVEDSO (Dispatcher). 
For entry ESTAEXIT: IEAVTAS1. 

ILRRLG — Release Logical Group Operator 

Operation: This routine releases auxiliary storage 

(unsaved slots) and control blocks (active ASPCTs) 

relating to a logical group. 

Entry from: ILRGOS or ILRSRBC. 

Exit to: Caller. 

ILRSAV — Save Operator 

Operation: This routine stores a logical group’s ASPCTs 

in the SYS1.STGINDEX data set and flags the 

individual LPMEs (slot information) as saved. 

Entry from: ILRGOS. 

Exit to. ILRGOS. 

ILRSRBC — VIO SRB Controller 

Operation: 
Entry point ILRSRBC: This routine is dispatched 
in the address space for which a group or page 
operation is pending. It finds the pending work, 


determines all work that can be started, and starts 
it. 
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Entry point ILRSRBRM: This routine cleans up 
resources. It frees the SRB scheduled to give 
ILRSRBC control or resets the schedule flag. 
Entry from: 
For entry point ILRSRBC: IEAVEDS0 for SRB 
scheduled by ILRGOS, ILRVIOCM, or 
ILRJTERM. 
For entry point ILRSRBRM: IEAVEPDQ. 
Exit to: TEAVEDSO. 
ILRSRBO1 — Recovery Routine for ILRSRBC 


Operation: This routine processes all errors which occur 
in ASM’s SRB controller. 


Entry from: TEAVTRTS (RTM). 

Exit to. TEAVTRTS. 

ILRSWAP — ASM Swap Control Module 

Operation: 
Entry point ILRSWAP: This routine receives swap 
requests from RSM and controls the placement or 
retrieval of the pages on either swap data sets or on 
page data sets (when no swap data sets are 
available). | 
Entry point ILRSLSQA: This routine builds and 
queues swap channel command workareas 
(SCCWs) for ILRSWPDR to start. 

Entry from: 


For entry point ILRSWAP: IEAVPIOI or 
IEAVSWIN. 


For entry point ILRSLSQA: ILRPAGCM or 
internally from ILRSWAP. 


Exit to: Caller. 

ILRSWPDR — Swap Driver 

Operation: This routine drives IOS via the STARTIO 
macro for pages being written to or read from a swap 


data set. 


Entry from: TEAVEDSO for SRB scheduled by 
ILRSLSQA (entry of ILRSWAP) or ILRCMP. 


Exit to: IEAVEDSO. 
ILRSWP01 — ASM Swap Recovery Routine 


Operation: This routine processes errors which occur in 
ASM’s swapping path. ILRSWPO1 entry receives 
control if there is an error in ILRSWPDR. 
ILRSCWAP entry receives control if there is an error 
in ILRSWAP. ILRCSLSQ entry receives control if 
there is an error in ILRSLSQA (an entry in 
ILRSWAP). 


Entry from: ILRIOFRR. 
Exit to. ILRIOFRR. 


ILRTERMR — ASM Address Space Termination 
Routine 


Operation: 
Entry ILRTERMR: This routine receives control 
during termination of any address space. All ASM 
resources for the address space including storage, 
control blocks, and auxiliary storage slots are freed 
or marked to be freed when in-process operations 
complete. 
Entry ILRSLTRV: This routine determines if 
sufficient unreserved slots exist to allow creation of 
another address space. 


Entry TERMRFRR: Recovery routine for 
ILRTERMR. 


Entry from: 
For entry IL_RTERMR: IEAVTMTC (RTM). 
For entry ILRSLTRV: IEAVITAS. 
For entry TERMFRR: IEAVTRTS (RTM). 
Exit to: 
For entry IERTERMR: IEAVTMTC. 
For entry ILRSLTRV: IEAVITAS. 


For entry TERMFRR: IEAVTRTS. 
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ILRTMIOI — Task Mode Initialization Recovery 


Operation. This ESTAE routine provides recovery for 
ILRTMRLG and its calls to ILRTMIO0 an 
ILRVSAMI. | 


Entry from: TEAVTAS1 (RTM). 

Exit to: TEAVTAS1. 

ILRTMRLG — Task Mode Release Logical Group 
Operation: This routine loads and calls ILRTMIOO to 
complete ASM initialization. It then waits to be posted 
for task mode release logical group processing (that is, 
erase saved ASPCTs and release the slots assigned in 
those ASPCTs). 

Entry from: TEAVEDSO (when initially attached by 
TEEMB860 or subsequently posted by ILRRLG or 
ILRTMIO1). 

Exit to: EAVEDS0 via WAIT. 

ILRVIOCM — VIO Completion 

Operation: This routine stores the newly-assigned LSID 
in an ASPCT for each complete I/O processing of a 
VIO page. 

Entry from: TILRPAGCM. 

Exit to: ITRPAGCM. 

ILRVSAMI — VSAM Interface Routine 

Operation: This routine interfaces with VSAM to 
complete any I/O to SYS1.STGINDEX involved in 
processing save, activate, and release logical group 
operations of ASM. 

Entry from: TLRACT, ILRSAV, or LRTMRLG. 

Exit to: Caller. 

IRARMANL — SRM Syntax Analyzer 

Operation: This module uses a syntax table 
(IPSYNTAB, ICSYNTAB or OPSYNTAB) to analyze 
the syntax of input data. Depending on the analysis, it 
transfers control to the required option initialization 


routine. 


Entry from: TIRARMIPS, IRARMICS, IRARMOPT, 
and IRARMANL (recursive). 
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Exit to: Caller. 
IRARMCNS — SRM Constants Module 


Operation: Provides the pre-assembled tables used 
within the SRM for non-refreshable data. 


Entry from: Not applicable. 
Exit to: Not applicable. 
IRARMCPM — SRM CPU Management 


Operation: Consists of a set of routines that monitor the 
system-wide processor load. They recommend users for 
swapping when the system is under- or over-utilized, 
and users exits that would improve the situation if 
swapped in or out. 


Entry from. TRARMCTL. 
Exit to: TRARMCTL. 
IRARMCPU — SRM CPU Adjustment Array 


Operation: This module contains model-dependent 
constants used by SRM to adjust some of its 
parameters. | 


Entry from: Not applicable (non-executable code). 
Exit to: Not applicable (non-executable code). 
IRARMCTL — SRM Control Algorithm 


Operation: This routine routes control to various SRM 
routines both as a result of explicit requests, and as a 
result of the expiration of internally scheduled periodic 
intervals. The routine defers the routing of control to 
certain requested routines until concurrently executing 
SRM processing completes. SRM control includes the 
routines that analyze the system users to determine 
which should be swapped in or out. 


Entry from: IRARMEVT when a SYSEVENT has been 
received, from IRARMFIP when a timed algorithm is 
due to be run, and from the dispatcher for the 
execution of an SRM SRB. 


Exit to: TRARMEVT or IRARMINT. 
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IRARMERR — SRM Functional Recovery 


Operation: This module provides functional error 
recovery for SRM. 


Entry from. Recovery termination manager. 
Exit to: Recovery termination manager. 


IRARMEVT — SRM SYSEVENT Routers and 
Processors 


Operation: This module translates information 
describing changes in the status of an address space or 
in the system environment from an external 
representation to an internal representation that can be 
acted upon by SRM. Also performs a limited number of 
specific services for other components. 


Entry from: TIRARMINT. 
Exit to: TIRARMINT or IRARMCTL. 
IRARMFIP — SRM Fast Interface Path 


Operation: This module performs the processing for 
those SYSEVENTs whose execution frequency or short 
path length makes the generalized path of IRARMINT 
unnecessary. 


Entry from: Any issuer of a SYSEVENT pre-defined as 
a candidate for a fast path event. 


Exit to: The SYSEVENT issuer, IRARMCTL, or 
IRARMINT. 


IRARMFMT — SRMDATA Print Dump Format Exit 


Operation: If the SRMDATA format control verb is 
specified in the print dump input, this module formats 
the three SRM swap queues of user control blocks 
(OUCBs). They are the WAIT, OUT, and IN queues. 
It also formats the domain table (DMDT), which 
controls the system’s multiprogramming level (MPL). 


Entry from: AMDPRUIM (an AMDPRDMP utility 
module). 


Exit to: AMDPRUIM. 


IRARMICS —~ SRM Installation Control Specification 
Processor 


Operation: This module scans the installation control 
specification list in the IEAICSxx member of 


SYS1.PARMLIB and builds a control block for 
installation control specification information. 


Entry from: TEEMB812. 
Exit to: TEEMB812. 
IRARMINT — SRM Interface Program 


Operation: This module performs the necessary 
processing for most branch entry and SVC 
SYSEVENTS to permit information pertaining to 
individual address spaces or system resources to be 
passed to and retrieved from SRM. 


Entry from. Most SYSEVENT issuers (branch type 
SYSEVENT), SVC processors (SVC type 
SYSEVENT), IRARMEVT, or IRARMCTL. 


Exit to: Most SYSEVENT issuers (branch type 
SYSEVENT), type 1 SVC exit routine (SVC type 
SYSEVENT), or the dispatcher (if an SVC entry and 
an SRB must be scheduled immediately). 


IRARMIOM — SRM I/O Management 


Operation: This module consists of a set of routines that 
monitor the I/O logical channel usage of certain 
address spaces. These routines recommend address 
spaces for swapping based upon the extent to which the 
swap-in or swap-out of the address space would correct 
a detected I/O imbalance. 


Entry from: TIRARMCTL. 
Exit to: TRARMCTL. 


IRARMIPM — IPS/Installation Control 
Specification/OPT Message Module 


Operation: This module contains the text for syntax 
error messages issued by IRARMIPS, IRARMICS, and 
IRARMOPT. 

Entry from: Not applicable. 

Exit to: Not applicable. 

IRARMIPS — SRM IPS Processor 

Operation: This module scans the installation 
performance specification (IPS) list in the IEAIPSxx 


member of SYS1.PARMLIB and builds control blocks 
for IPS information. 
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Entry from: TEEMB8 12. 
Exit to: TEEMB812. 
IRARMMSG — SRM Message Module 


Operation. This module contains the WTO list macro 
forms of SRM messages. 


Entry from: Not applicable. 

Exit to: Not applicable. 

IRARMOPT — SRM OPT Processor 

Operation: This module scans the OPT list in the 
TEAOPTxx member of SYS1.PARMLIB and builds a 
parameter list containing the new values for the OPT 
variables. 

Entry from: TEEMB812. 

Exit to. TEEMB812. 

IRARMRMR — SRM Resource Monitor 

Operation. This module accumulates several system 
resource contention indicators, computes the average 
utilization of these resources and based on the level of 
utilization, raises or lowers the system . 
multiprogramming level (MPL). It also adjusts vient 
maximum think time for logical swapping. 

Entry from: TIRARMCTL. 

Exit to. TIRARMCTL. 


IRARMSET — SRM Non-Resident Set to 
New-Parmlib Member 


Operation: This module replaces the internal SRM 
constants and control blocks with information from the 
appropriate parmlib member (IEAIPSxx, IEATICSxx, or 
TEAOPTxx) in response to SET IPS, SET ICS, or SET 
OPT. 


Entry from: TRARMEVT. 
Exit to. TRARMEVT. 


IRARMSRV —— SRM Supervisor Service Request 
Routine 


Operation. This module requests the invocation of 


specific supervisor services for SRM routines. The 
supervisor services requested include reordering the 
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ASCB chain, stealing page frames, and obtaining or 
freeing storage in the SRM storage pool. 


Entry from. An SRM routine. 
Exit to: The invoking routine. 
IRARMSTM — SRM Storage Management 


Operation: Consists of a set of routines that control the 
use of main storage by all address spaces. For 
non-swappable users, the mechanism of page stealing is 
used for storage management control; for swappable 
users, both page stealing and swapping provide the 
requisite control. 


Entry from: TIRARMCTL and IRARMEVT. 
Exit to: TRARMCTL and IRARMEVT. 


IRARMST2 — SRM Storage Management Subroutine 
Module 


Operation: This module consists of a set of routines that 
evaluate and manage the use of main storage. 
IRARMST72 is an extension of IRARMSTM. 


Entry from: TRARMCTL and IRARMEVT. 
Exit to: IRARMCTL and IRARMEVT. 
IRARMSWP — Swap Analysis Algorithm 


Operation. This module updates the domain descriptor 
table (DMDT) and selects the users to swap in or out. 
The swap decisions are based on the current domain 
targets and user swap recommendation values supplied 
by the workload manager and the resource load 
balancers, if they are active. 


Entry from: TRARMCTL. 
Exit to: TRARMCTL. 


IRARMWAR — SRM Workload Activity Recording 
Routine 


Operation: Collects workload activity data when so 
requested by RMF. Terminates the collection of 
workload activity data when so requested by RMF, or 
when the IPS or installation control specification is 
changed. 
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Entry from: IRARMEVT or IRARMWLM. 
Exit to. IRARMEVT or IRARMWLM. 


IRARMWLM — SRM Workload Manager Algorithm 
Module - Part 1 


Operation: Consists of a set of routines that update user 
transaction statistics, and monitor the workload level at 
which individual users are receiving service. 


Entry from: [RARMCTL and IRARMEVT. 


Exit to: TIRARMCTL and IRARMEVT. 


IRARMWLS — SRM Workload Manager Algorithm 
Module - Part 2 


Operation: Consists of a set of routines that perform 
user-ready processing and queue processing for 
subsystem transaction reporting. This module is an 
extension to IRARMWLM. 

Entry from: TIRARMCTL and IRARMEVT. 

Exit to: TRARMCTL and IRARMEVT. 


ISGxxxxx 


Modules whose names begin with “ISG” are described 
in OS/VS2 Global Resource Serialization Logic. 
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Index 


A 
ABDUMP, initialization 11-38 
ABDUMP routine 11-38 
address conversion routine 11-38 
address space 
delete 11-10 
initialization 11-27 
address space control block (see ASCB) 
algorithm tables, update (allocation) 11-90 
allocate request to unit 11-94 
allocation address space initialization 11-107 
allocation resource manager ESTAE exit routine 11-88 
allocation/termination communication area 11-113 
allocation/unallocation 
affinity processor 11-94 
affinity remover 11-95 
algorithm tables, update 11-90 
allocated UCB list, build 11-95 
allocation via algorithm 11-98 
alternate disposition message routine 11-86 
AVR (automatic volume recognition) control 11-97 
build 
eligible device list (EDL) 11-93 
SWA tables for dynamic allocation request 11-106 
build/update/rebuild expandable TIOT 11-93 
catalog allocation contro! 11-91 
catalog unallocation control 11-90 
common allocation 
cleanup 11-100 
control 11-92 
ESTAE exit routine 11-87,11-89 
common unallocation 
control 11-85 
ESTAE exit routine 11-87 
concatenation routine 11-106 
cover/reduce algorithm 11-98 
data set name resolution 11-96 
data set release 11-86 
data set reservation/release 11-87 
DCB resolution 11-96 
DD function control 11-96 
DD preparation 11-95 
DD processing control 11-95 
ddname 
generation routine 11-104 
search routine 11-104 
DDNAME/JES3 exit changing 11-104 
DDR count routine, update 11-95 
DD-related messages 11-102 
deconcatenation routine 11-106 
demand allocation 11-98 
determine device requirements 11-93 
device allocation, defaults 11-95 
device end POST handler 11-100 
direct access label read 11-91 
disposition 
message routine 11-86 
messages 11-92 
processing control 11-86 
processor 11-96 
dsname search routine 11-103 
DSORG obtain routine 11-104 
dynamic allocation 
build SWA tables 11-106 
control 11-105 
contro! routine 11-105 


convert routine 11-105 
ddname allocation 11-107 
dynamic information retrieval 11-106 
ESTAE exit 11-105 
function validity checker 11-105 
installation exit 11-105 
interface routine (DAIR) 11-103 
JFCB DCB field update 11-106 
normal error subroutine 11-106 
remove in-use control routine 11-106 
remove in-use processor 11-106 
set DSABDCBM mask bits subroutine 11-89 
dynamic unallocation 
control routine 11-103 
processor 11-103 
EDL (eligible device list), build 11-93 
eliminate ineligible groups and generics 11-99 
ENQ/DEQ routine, generalized conditional 11-90 
fixed device (main path) control 11-93 
from groups picked by algorithm 11-98 
function control 11-105 
GDG single processor 11-96 
generic allocation contro! 11-97 
generic processing, build tables for 11-97 
group lock/unlock ESTAE exit 11-89 
group lock/unlock interface 11-87 
GSPACE/FSPACE service routines 11-91 
initiator/allocation interface 11-102 
initiator/unallocation interface 11-102 
JES3 interface 11-93 
JFCB housekeeping 
control 11-95 
ESTAE exit routine 11-87 
JLOCATE 11-97 
job status messages 11-101 
job unallocation 11-103 
job/step allocation ESTAE exit 11-88 
job/step allocation retry routine 11-88 
job/step unallocation ESTAE exit 11-87 
message compression routine 11-90 
message routine 11-88 
messages 11-92 
mount control routine 11-101 
multiple device type determination 11-96 
multi-unit/multi-generic request processor 11-98 
MVCA chain processor 11-101 
honspecific volume allocation contro] 11-94 
offline/allocated device allocation 11-99 
passed data set information (PDI) 
read and chain 11-87 
scan 11-96 
PCCB routine 11-88 
process job condition codes 11-103 
process offlines/allocated units 11-98 
queue manager 11-89 
recovery, interface with operator 11-99 
recovery allocation 11-99 
messages 11-92 
of online devices 11-99 
recovery reply options processor 11-99 
resource manager 11-89 
SIOT/JFCB creation 11-97 
SMF dynamic DD routine 11-104 
specific volume allocation control 11-94 
step allocation control 11-102 
step unallocation control 11-103 


Index | 


step-related messages 11-102 
subsystem data sets 11-93 

SWA manager interface 11-91 

SWA reader routine 11-90 

syntax checker 11-104 

system message interface routine 11-90 
tape label read 11-91 

TCTIOT contro! 11-104 

TCTIOT FRR routine 11-105 
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swap 
driver 11-137 
format routine 11-132 
recovery routine 11-137 
swap control routine 11-137 
task mode initialization recovery 11-138 
task mode release logical group 11-138 
V1O completion 11-138 
VSAM interface routine 11-138 


test assign/unassign 
device ready 11-88 service routine 11-101 
EXEC statement condition codes 11-102 hardware 11-101 
volume ENQ 11-90 ASVT verification reconstruction routine 11-22 


TIOT manager control routine 11-89 asynchronous exit queue handler (stage 2) 11-13 

TP (teleprocessing) request processor 11-93 asynchronous service routine, communications task 11-30 
UCB FRR exit routine, update 11-89 ATTACH 

UCB update routine 11-94 interface routine 11-113 

unallocate requests to be rearranged 11-98 service routine 11-10 


unallocation messages 11-102 attention exit 

unit name conversion 11-97 epilog routine 11-8 
unit unallocation contro! 11-86 prolog routine 11-8 
unit verification 11-92 purge routine 11-8 
verify control routine 11-101 scheduler routine 11-8 


VIO data sets 11-94 AVR, WTO message module for 11-92 
VM & V (volume mount and verify) 
control 11-100 
DOMR & cleanup routine 11-99 
ESTAE exit routine 11-88 B 
FRR exit routine 11-88 bind break service routine 11-11 
interface 11-100 BLDL/ program fetch interface 11-27 
messages 11-91 
WTO/WTOR formatter 11-101 
volume 
release 11-86 C 
unit table completion 11-97 C,K display processor 11-81 
unload control 11-100 CALLRTM TYPE=RMGRCML processor, module description 
validity checker 11-95 11-42 
volume/unit resolution 11-96 CANCEL/FORCE command handler 11-82 
volunit affinity processor 11-93 CCH (channel check handler) 
wait holding resources 11-100 central routine 11-124 
within a generic 11-98 channel dependent analysis 
WTO messages for IEFBB410 11-102 for integrated channels 11-124 
alternate CPU recovery (ACR) 11-38 for 2860 channel 11-125 
AMDPRDMP, service aid exit for SUMDUMP control statement for 2870 channel 11-125 


11-40 for 2880 channel 11-125 
ASCB external damage machine check 11-124 
creation 11-8! NSLREPOS interface 11-123 


dispatching queue manipulation routine 11-10 channel program build routine 11-132 
ASM (auxiliary storage management) CHAP, service routine 11-11 
address space termination routine 11-137 checkpoint/restart - 
ASM I/O completion 11-131 automatic checkpoint/restart message module 11-122 
common and VIO areas format routine 11-132 create step header 11-122 
format routine 11-132 data set, descriptor record processor 11-122 
free slot routine 11-133 journal merge routine 11-122 
group operation starter 11-133 journal write routine 11-121 
group operators recovery routine 11-134 locate mode restart interface processing 11-122 
ILRSRBC, recovery routine 11-137 move mode restart interface processing 11-122 
I/O completion recovery routine 11-132 move mode restart interface routine 11-122 
I/O control recovery routine 11-134 open checkpoint data set routine 11-122 
job termination resource manager 11-134 restart interruption handler 11-18 
message module 11-135 recovery routine 11-18 
page and swap expansion 11-135 restart preparation routine 11-113 
page I/O completion 11-135 CHNGDUMP command, processor 11-69 
page or swap open routine 11-135 CIRB (create IRB) 11-14 
paging format routine 11-132 CMSET service routine 11-11 
recovery service routines 11-133 command processing 
release logical group operator 11-136 command scheduler router 11-80 
save operator 11-136 command translation routine 11-83 
special read/write routine 11-136 console information message routine 11-83 
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console information message routine 2 11-85 
console operand processor 11-83 
device subroutine 11-76 
ESTAE create/exit routine 11-58 
ESTAE exit routine 11-83 
message assembly 11-80 
monitor queue manager 11-31 
routing and list operand processor 11-85 
stop track and stop monitor processor 11-83 
stop/restart subroutine 11-75 
system-initiated cancel schedule routine 1t-131 
system-initiated cancel SRB routine 11-131 
command routine 11-58 
command scheduling control block (see CSCB) 
common allocation 
cleanup 11-100 
control 11-92 
ESTAE exit routine 11-87,11-89 
WTO message module for 11-92 
common unallocation 
control 11-85 
ESTAE exit routine 11-87 
communications task 
asynchronous service routine 11-30 
command queuer 11-10 
console attention processor 11-51 
console queueing routine 11-32 
console switch routine 11-37 
device service routine 11-30 
DOM processor 1] 1-30 
DOM service routine (SVC 87) 11-52 
ESTAE routine 11-36 
multiple-line WTO service routine 11-32 
operator interrupt key interrupt processor 11-51 
process message for inactive terminal (console) 11-31 
queue scanner 11-33 
wait service routine 11-31 
console device support processor 
1052 console 11-4 
1443 console 11-5 
2540 console 11-5 
2740 console 11-67 
3284/3286 console 11-63 
console dump 11-58 
console loop trace data obtained by IEAVTSDH 11-47 
console queueing routine, communications task 11-32 
console switch routine, communications task 11-37 
CONTROL and MSGRT commands, error message module 2 
11-84 
CONTROL and STOPTR commands, processor 11-84 
CONTROL C,A/E/I command handler 11-85 
CONTROL C,D command handler 11-85 
CONTROL command, syntax checker (DIDOCS) 11-60 
CONTROL M command handler 11-85 
CONTROL Q command 11-85 
CONTROL V command handler 11-85 
converter 
command verb validation routine 11-120 
comment or continuation validation routine 11-119 
converter/interpreter 
message module 11-119 
operator message module 11-120 
SMF user exit routine 11-118 
GET routine 11-119 
initialization routine 11-120 


in-stream procedure 
control and GTF routine 11-120 
directory build routine 11-121 
directory search routine 11-121 
expand interface routine 11-121 
syntax checker 11-121 

NULL statement or END-OF-FILE processor 11-120 

pre-scan routine 11-119 

scan routine 11-118 

SWA manager interface 11-120 

symbolic parameter routine 11-118 

termination routine 11-119 

test and store utility routine 11-119 

verb identifier routine 11-119 


CPU recovery, alternate 11-38 
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MDLESTAE, ESTAE for IEAVEMDL 11-15 
memory 
create 11-15 
delete 11-15 
initialization 11-15 
purges and exit 11-43 
request 11-15 
memory switch, routine 11-15 
memory termination 
controller 11-41 
purges 11-41 
requester 11-41 
message and subroutine name CSECT for IEAVTFSD 11-40 
message module for parmlib process 11-69 
message table handler, type 1 11-41 
MFDATA SVC mainline processor 11-131 
MFSTART mainline processor 11-131 
MIH (missing interruption handler) 
DIE routine 11-130 
module 11-130 
MLWTO (multiple-line WTO), service routine, communications 
task 11-32 
MODE command, processor 11-130 
MODIFY and STOP command processor 11-81 
modify device online/offline status 11-91 
module-obtain routine for virtual fetch 11-3 
MONITOR command, processor 11-84 
monitoring and system support facility routines (see MSSFCALL) 
MOUNT command 
processor 11-77 
syntax check routine 11-77 
MP VARY command pre-processor 11-82 
MPF, scan routine 11-32 
MSGRT (message route) command 
handlerI 11-84 
handler IT 11-84 
MSGRT and CONTROL command, message module 11-83 
MSS, preprocessor 11-85 
MSSFCALL SLIH routine (see also IEAVMFIH) 
module description 11-31 
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MSSFCALL SRB routine (see also IEAVMSFS) 11-31 
MSSFCALL SVC resource manager, module description 11-31 
MSSFCALL SVC routine 11-31 


N 

non-allocation unload interface 11-100 

non-standard label routine (user-replaceable) 11-122 
nucleus entry point table module 11-54 


O 
offline/unload pending processing 11-93 
operator interrupt key interrupt processor, communications task 
11-5! 
overlay supervisor 
processor 11-122 
resident processor 11-122 


page 
find in RSM _ 11-23 
fixin RSM 11-24 
invalidation routine 11-27 
1/0 post 11-32 
load in RSM 11-24 
release (PGRLSE) 11-34 
validate routine 11-75 
page operations starter 11-135 
page release (see PGRLSE) 
paging I/O completion processor 11-27 
parmlib variable messages 11-72 
PC/AUTH resource manager (see IEAVXPAM) 
PC/AUTH service routines 
connecting an entry table 11-53 
creating an entry table 11-53 
deleting an entry table 11-53 
disconnecting an entry table 11-53 
entry point search module 11-53 
extracting an AX 11-55 
freeing an AX 11-55 
freeing an LX 11-54 
FRR for 11-55 
memory initialization 11-54 
PCLINK STACK, UNSTACK, and EXTRACT 11-56 
reserving an AX 11-55 
reserving an LX 11-54 
setting an AT entry 11-55 
setting an AX 11-55 
performance group reset module 11-68 
PFK (program function key) 
definition processor (DIDOCS) 11-65,11-67 
display processor 11-82 
entered command processor (DIDOCS) 11-65 
PFTE enqueue/dequeue routine 11-32 
PGFREE 11-23 
PGRLSE (page release) 11-34 
pool extender routine 11-135 
positional parser routine (see IEEMB822) 11-73 
POST, service routine 11-37 
process pending offlines/unloads 11-93 
processor/channel 
logical reconfiguration routine 11-75 
reconfiguration routine 11-75 
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program check interrupt 
extension 11-33 
handler 11-16 
program first level interrupt handler 
DAT-off section 11-16 
DAT-on section 11-16 
recovery routine 11-17 
program management 
recovery routine 11-29 
resource management routines 11-29 
program management module 11-29 
program properties table 11-113 
PSI (page services interface) module 11-33 
PURGEDQ 
recovery routine 11-17 
service routine 11-17 
PWF, machine check handler appendage 11-3 


QEDIT and MGCR macro function processor, control block chain 
manipulator 11-80 
queue manipulation routine (task management) 11-16 
quickcell pool 
build 11-9 
delete 11-10 
QUIESCE command, processor 11-74 


R 
RCT (region control task) 
common processing 11-8 
initialization/termination 11-7 
quiesce routine 11-8 
restore routine 11-8 
real storage configuration 11-33 
real storage reconfiguration module 11-33 
reconfiguration message module 11-76 
recording task, asynchronous 11-42 
recovery routine 
for allocation 11-89 
for IEAVTRT1 11-45 
for IEAVTSR1 11-50 
for IEAVXSTK 11-56 
for ILRIODRV and ILRCPBLD 11-132 
for ILRSRBC 11-137 
for PC/AUTH service routines 11-55 
schedule 11-18 
SVC IH 11-21 
recovery termination, master scheduler initialization controller 
11-41 
reply processor, stage 2 11-52 
reply syntax checker 11-58 
restart FLIH extension 11-18 
roll mode processor (DIDOCS) 11-62 
RSM (real storage management) 
address space, initialization 11-27 
build quickcell pool 11-9 
create segment 11-9 
delete address space 11-10 
destroy segment table entry 11-10 
find page 11-23 
frame allocation steal function 11-33 
general frame allocation 11-24 
general frame allocation extension 11-24 
page fix/page load 11-24 
page out 11-32 


Licensed Material — Property of IBM 


paging termination services 11-40 
PCB manager 11-32 
real frame replacement and UIC update 11-34 
recovery 11-34 
swap-out 11-36 
translate real to virtual 11-46 
window service routine 11-52 

RTM (recovery termination management) 
asynchronous recording task 11-42 
contro! block formatter mainline 11-40 
control task purges,memory purges and exit 11-43 
hardware error processor 11-43 
memory resource manager 11-41 
recording request routine 11-42 
recovery routines 11-44 
RTM2WA, ESA, SDWA formatter 11-4 
SCB-RTCT control block formatter 11-4 
task termination 11-49 
type 1 message table handler 11-41 
user retry 11-39 

RTM dumping services (see dump formatting) 

RTMI1 (recovery termination management number 1) 
description 11-43 
entry point processor 11-45 
service routines 11-42 

RTM2 (recovery termination management number 2) 
control task purges, memory purges and exit 11-43 
initialization (SVC 13 entry point) 11-46 
mainline controller 11-43 


S 
SCB FREEMAIN routine 11-47 
SCHEDULE 
recovery routine 11-18 
service routine 11-19 
scheduled commands table 11-74 
scheduler JCL facility 
build SWB routine 11-114 
control routine 11-114 
define JDVT routine 11-114 
delete SWB chain routine 11-115 
extract routine 11-115 
find JDVT routine 11-116 
find SWB chain routine 11-115 
get SWB chain routine 11-115 
JDVT initialization routine 11-116 
put SWB routine 11-116 
retrieve routine 11-116 
update routine 11-116 
write SWB routine 11-117 
segment, create in RSM 11-9 
SEND command 
*now’ processor 11-78 
cleanup routine 11-77 
I/O routine 11-77 
list handler 11-77 
mail handler 11-77 
main control 11-77 
message module 11-131 
notice handler 11-78 
scanner 11-131 
service routine 
assign/unassign 11-101 
hardware 11-101 
ESTAE 11-37 
STIMER 11-35 
subsystem affinity table 11-21 
TIME 11-35 


TTIMER 11-35 
VARY device 11-58 
service routines, getmain/freemain 11-25,11-26 
SET command 
immediate routine for 11-80 
keyword table 11-72 
SET IPS, installation control specification, OPT processor 11-69 
set local time 11-84 
SET MPF processor (see IEECB805) 11-57 
set time-of-day clock routine 11-84 
SETDIE routine 11-35 
SETDMN command, processor 11-85 
SETFRR (see IEAVTSFR) 
SETFRR routine 11-49 
SETLOCK 
repair routine 11-15 
service routine 11-15 
SETSMF processor 11-60 
SGTE (segment table entry) 
destroy in RSM 11-10 
single-line message processor (DIDOCS) 11-67 
SLIP (serviceability level indication process) 
action processor part 1 11-49 
action processor part 2 11-49 
action processor part 3 11-49 
command 
interpreter 11-59 
processor 11-59 
ESTAE routine 11-59 
global PER activation/deactivation routine 11-40 
local PER activation/deactivation routine 11-41 
message module 11-59 
PER RISGNL routine 11-49 
PER selection interface routine 11-41 
POST routine 11-60 
processor recovery 11-50 
program FLIH/SLIP PER/SPACE switch interface 11-41 
recovery 11-50 
service routine 11-50 
space switch handler 11-51 
trap matching 11-50 
TSO communication routine, display 11-60 
SMF (system management facilities) 
converter/interpreter, user exit routine 11-118 
data set dump module 11-123 
data set initialization 11-69 
dynamic dd data collection module 11-72 
dynamic DD data collector 11-69 
dynamic DD routine 11-104 
ESTAE exit routine 11-70 
EXCP counter routine 11-4 
exit write-to-programmer processor 11-117 
initialization ESTAE 11-70 
initialization exit supporter 11-117 
initialization record processor 11-70 
initialization router 11-69 
input merge 11-69 
interval data collection module 11-71 
job and step termination processor 11-117 
job and step termination record assembler 11-117 
list options module 11-71 
macro module 11-72 
MAXDORM and STATUS processor 11-72 
message language part table 11-72 
message processor 11-70 
message processor language parts table 11-70 
message processor table 11-70 
OPEN initialization 11-70 
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option tables 11-71 
queue options module 11-71 
record manager 11-71 
record writer routine 11-70 
SET command processor 11-71 
STAE exit message module 11-70 
STAE exit routine 11-70 
summary activity report for IFASMFDP 11-123 
suspend/reset interface 11-4 
syntax analyzer 11-71 
system address space processing 11-123 
system address space processing initialization 11-123 
system address space setup 11-123 
time limit extension 11-4 
timer program 11-72 
user job initiation exit routine 11-118 
user step initiation exit routine 11-118 
user time limit exit routine 11-118 
writer message module 11-70 
writer SRB 11-71 
writer SVC 11-71 
writer task 11-70 
SMF VARY record handler 11-81 
SNAP 
format and format 01 routines 11-7 
format router 11-7 
format 20 and format 22 routines 11-7 
mainline 11-6 
output routines 11-7 
TCAM, GTF, VSAM, shared resources interface and 
installation formatters 11-6 
space switch event mask manager 11-20 
space switch extension 11-51 
special scratch/catalog processor 11-86 
SPIE SRB routine 11-19 
SPIE/EXTRACT service routine 11-39 
spool file allocation routine, module description 11-92 
SQA allocation 11-36 
SRB, time limit initialization 11-35 
SRB routine to invoke ILRPAGCM 11-132 
SRB status SAVE/RESTORE/MODIFY routine 11-21 
SRB/SSRB pool manager 11-19 
SRM (system resources manager) 
constants module 11-138 
control algorithm 11-138 
CPU adjustment array 11-138 
CPU management 11-138 
display domain processor 11-68 
fast interface path 11-139 
functional recovery 11-139 
installation control specification processor 11-139 
interface module 11-139 
1/O management routines 11-139 
message module 11-140 
non-resident set to new IPS routine 11-140 
resource monitor 11-140 
storage management 11-140 
storage management subroutine module 11-140 
workload manager algorithm module 11-140 
SRMDATA print dump format exit 11-139 
STAR routine, communications task 11-36 
START command, syntax check routine 11-78 
status display processor (DIDOCS) 11-66,11-67 
STATUS service routine 11-36 
STAX SVC service routine 11-9 
STC (started task control) 
free region routine 11-74 
get JSCB routine 11-75 
get region routine 11-74 
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message module 11-77 
recovery exit routine 11-75 
SWA and TIOT initialization for private catalog processor 
11-74 
write JCL routine 11-111 
STIMER service routine (SVC 47) 11-35 
STOP command, processor 11-81 
STOP/RESET service routine (see IEAVESRT) 11-20 
storage key, change 11-9 
subsystem 
initialization 11-111 
initialization and PARMLIB messages 11-111 


initialization and PARMLIB processing message writer 11-111 


interface initialization 11-111 
interface resource manager 11-110 
service routine 11-111 
vector table service 11-111 
SUMDUMP control statement, AMDPRDMP service aid exit 
11-40 
summary dump 
HEX format subroutine 11-40 
IEAVTFSD and RTM contro! block formatters, interface 
between 11-40 
read subroutine 11-40 
writer, SVC DUMP 11-48 
supervisor control 
FRR (super FRR) 11-19 
low core refresh 11-15 
queue verifier 11-17 
stage 2 asynchronous exit queue handler 11-13 
stage 3 exit effector 11-13 
recovery routine 11-13 
trace routine 11-42 
validity check 11-22 
SUSPEND/RESUME/TCTL processor 11-22 
SVC dump 
branch entry 11-49 
clean up routine 11-47 
data set initialization 11-47 
disabled summary dump processor 11-50 
enabled summary dump processor 11-50 
exit interface routine 11-48 
global storage processor 11-47 
GTF trace processor 11-47 
initialization routine 11-47 
local storage processor 11-48 
output processor 11-48 
resources manager 11-48 
summary dump data move routine 11-51 
summary dump writer 11-48 
suspend summary dump processor 11-51 
task 11-48 
SVC first level interruption handler 11-21 
SVC interrupt handler, recovery routine 11-21 
SVC 11 TIME service routine 11-35 
SVC 110 
interface 11-74 
router, master scheduler 11-80 
SVC 13 entry point, RTM2 initialization 11-46 
SVC 35 (WTO/WTOR macro instruction), communications task 
11-52 
SVC 36 write-to-log (WTL) processor 11-68 
SVC 46 TTIMER service routine 11-35 
SVC 47 STIMER service routine 11-35 
SVC 51 11-6 
SVC 60 ESTAE service routine 11-37 
SVC 72 router 11-52 
SVC 87 DOM service routine, communications task 11-52 
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SWA manager 
interface 11-113 
converter 11-120 
locate mode functions 11-112 
move mode functions 11-112 
QMNGRIO macro interface handler 11-112 
swap analysis algorithm 11-140 
SWAP command, processor 11-130 
SWAP I/O initiator 11-32 
swap-in, completion processor 11-37 
swap-out, completion processor 11-37 
SWB (scheduler work block) 
build routine 11-114 
delete chain routine 11-115 
find chain routine 11-115 
get chain routine 11-115 
put routine 11-116 
retrieving parameter information from 11-116 
write routine 11-117 
SWITCH command, syntax checker 11-81 
switch SMF processor 11-84 
system address space create routine 11-73 
system address space initialization WAIT/POST routine (see 
TEEMB883) 
system function table module 11-56 
system log | 
ESTAE processor 11-68 
initialization/writer 11-68 
message module 11-68 
resource initialization 11-68 
system recovery manager 11-45 
SYS1.BRODCAST data set access controller 11-78 
SYSI-PARMLIB read routine (see IEEMB878) 


T 
task management 
exit 11-16 
mode change routine 11-31 
queue manipulation routine 11-16 
task recovery 
post exit processor in RTM 11-39 
pre-exit processor in RTM 11-38 
resource manager 11-46 
TESTAUTH, service routine 11-40 
timer supervision 
time purge and recovery 11-35 
TIME service routine 11-35 
timer second level interrupt handler 11-34 
TOD clock, manager 11-35 
TRACE command, module description 11-58 
TRACK command, processor 11-57 
TRACK router 11-82 
TSO command counter 11-131 
TSO command table for accounting 11-72 
TTIMER service routine (SVC 46) 11-35 
type 30 setup record for SMF 11-117 
type 30 SMF record builder 11-118 
type 32 setup record for SMF 11-117 
type 32 SMF record builder 11-118 


U 
UCME scanner for VARY command 11-82 
unit status 

load 1 11-81 

load 2 11-81 


load 3 11-81 

load 4 11-81 
UNLOAD command, syntax scanner 11-69 
user formatter CSECT 11-5 


V 
VeR allocation 11-17 
VARY 
channel processor 11-75 
CN console processor 11-59 
CN syntax processor 11-59 
CPU 
stop routine 11-79 
wakeup and quiet routines 11-80 
HARDCOPY 
OFF processor 11-83 
operand processor 11-83 
processor II 11-84 
keyword, scan 11-82 
keyword scanner 11-83 
master console command processor 11-83 
ONLINE/OFFLINE 
for console devices 11-83 
processor 11-82 


ONLINE/OFFLINE/CONSOLE, syntax scan 11-82 


path, command processor 11-77 
range processor 11-59 
storage processor 11-74 
UCME scanner 11-82 
VARY CPU/channel 
cleanup and recovery routine 11-60 
command processor 11-76 
logical reconfiguration processor 11-75 
processor 11-75 
reconfiguration processor 11-75 
VARY device 
ESTAE exit routine 11-58 
ESTAE routine 11-58 
service routine 11-58 
VARY STOR 
command processor 11-79 
ESTAE routine 11-79 
vary storage 
element offline, find alternatives for 11-78 
element reconfiguration module 11-78 
logical routine 11-78 
physical routine 11-78 
VIO 
ASPCT routine, activate 11-131 
services interface 11-7 
SRB controller 11-136 
virtual fetch 
BUILD and FIND routine 11-2 
initialization module 11-2 
memory termination manager 11-3 
module formatter 11-2 
module obtain routine 11-2 
refresh module 11-3 
search routine 11-3 
VSM (virtual storage management) 
change storage key 11-9 
delete quickcell pool 11-10 
FREECELL 11-23 
GETCELL 11-26 
GETMAIN/FREEMAIN 11-25 
GETPART/FREEPART 11-33 
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task termination 1 

create address space routine 11-24 1052 console device support processor 11-4 

free address space routine 11-24 1443 console device support processor 11-5 
W 2 
wait/post service routine 11-37 2250 device I/O module (DIDOCS) 
window service routine 11-52 part 1 11-62 
WOQE service routine 11-26 : part 2 11-62 
WQE/ORE purge routine 11-30 2260 device I/O module (DIDOCS), part 1 11-62 
WRITELOG, command processor 11-81 2260 device I/O module-Part 2 (DIDOCS) 11-67 
WTL (write-to-log), processor (SVC 36) 11-68 2540 console device support processor 11-5 
WTO and TPUT issuer for DISPLAY and TRACK commands 2740 console device support processor 11-67 

11-57 


WTO message module for AVR and common allocation 11-92 
WTP (write-to-programmer) 


buffer routine 11-57 3 
processor 11-123 3PC (interprocessor communication), external interruption routine 


PUT routine 11-57 11-13 
| 3066 device I/O module (DIDOCS) 11-62 
3270 device, model 158 system console I/O module (DIDOCS) 
11-63 
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